The Templates API lets Wix Studio partners turn their sites into reusable templates, create new sites from those templates, and publish templates so that other Wix accounts can use them.
A template is a reusable starting point for new sites, based on an existing site. When you create a site from a template, the new site is a duplicate of the template's site, so a partner can build a layout once and reuse it across many sites.
With the Templates API, you can:
- Create a template from an existing site.
- Create new sites from a template.
- Publish a template, turning it into a public template that other Wix accounts can clone.
- Retrieve, query, count, update, and delete templates.
A template typically moves through these stages:
- Creation: A partner creates a template from one of their existing sites. The most common path duplicates the site first and turns the duplicate into a template, leaving the original site unchanged.
- Reuse: A partner creates new sites from the template within their account. Each generated site is a duplicate of the template's site and is tracked in the template's
sites list.
- Publishing: A partner publishes the template, turning it into a public template. Publishing creates a separate, public snapshot of the template's site that other Wix accounts can clone. Republishing replaces the public snapshot with the latest version of the site.
Being a public template is a prerequisite for listing a template on the template marketplace, but the marketplace listing process is separate and isn't handled by this API.
It's important to note the following points before starting to code:
- A template is always created from an existing site. You can't create an empty template.
- Creating a site from a template duplicates the template's underlying site each time.
- Deleting a template also deletes the site the template is based on.
- A template's
platform, either Wix Studio or the Wix Editor, is derived automatically from its site and can't be set directly.
- Template: A reusable starting point for new sites, based on an existing site.
- Public template: A published template that other Wix accounts can clone, either through a template marketplace order or a shareable link.
- Template marketplace: A marketplace where partners can list public templates for other accounts to purchase. Listing is managed separately from this API.
- Shareable link: A link, backed by a shareable key, that lets the template owner give other accounts access to clone a public template.