Get to know our frameworks

Select an app template built on your preferred framework.

Build apps on our native app editor. Use drag and drop elements, Velo code and Wix APIs to develop custom features.

Streamline your app development process with the Wix CLI. Get a familiar developer experience with minimal setup and configuration.

Take full control over your app's tech stack, deployment, and hosting.

App templates

Wix Blocks templates

Wix CLI templates

Self-hosted templates

Kickstart your app development with templates built on your preferred Wix developer tool. Browse templates for practical foundation and get to know the Wix ecosystem.

Wix App Templates for Developers

This example apps can be used as a starting point for building your own app, for concrete examples of how to use Wix framework, or for inspiration.

Choose a template.<0 />Build an app.

Browse by:

How to build it step by step:

This template is built with:

Read how this template was built, step by step.

How we built this template

Deployment instructions:

Choose a package manager and run the command in your terminal.

Copy command

Before you get started, make sure you have the following:

Prerequisite steps

Get started with Wix CLI

Begin by setting up your Next.js project with your preferred hosting platform.

Select your hosting service

Start the deployment flow and set up your template repo on Netlify. After you finish set up, come back here and add your Netlify custom domain.

Copy the code from our Git repo to deploy your app on any platform that supports Next.js.

Start the deployment flow and set up your template repo on Vercel. After you finish set up, come back here and add your Vercel generated URL.

Add the base URL and give your app a name.

App details

Go to the app dashboard and test your app to ensure a smooth integration within the Wix ecosystem. <0>Learn more about app checks and testing</0>

Define your environment

Terminal

Related templates

Note

Warning

Your app name will be used as the namespace suffix.

Name your app to generate a namespace. This lets you refer to your app in code later on.

Go Headless

Build Apps

Client

API Preview

Ricos

Develop Websites

REST

Velo

GraphQL (Alpha)

Retrieves the version of Stores Catalog installed on a site.

import { catalogProvision } from '@wix/stores';

async function getCatalogVersion() {
  const response = await catalogProvision.getCatalogVersion();
};

getCatalogVersion: Wix-hosted

import { createClient } from '@wix/sdk';
import { catalogProvision } from '@wix/stores';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { catalogProvision },
  // Include the auth strategy and host as relevant
});


async function getCatalogVersion() {
  const response = await myWixClient.catalogProvision.getCatalogVersion();
};

Self-hosted SDK calls require you to [create a client](https://www.sbdautomotive.com/ja/wg-cgi/dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client).

getCatalogVersion: Self-hosted

getCatalogVersion

Manage Stores - all permissions

Read Stores - all read permissions

Manage Orders

Manage Products

Read Products

Manage Restaurants - all permissions

Read v3 catalog

Manage v3 catalog

GetCatalogVersionResponse

# About the Catalog Versioning API

The Catalog Versioning API allows you to determine what version of the Wix Stores Catalog a site is using.

The two versions of the catalog are not backwards compatible. Supporting both versions of the catalog is critical, as sites will be spread across both versions.

## Motivation
In order to support our customers' needs and to support the best practices in a modern eCommerce platform, WixStores
has developed a new API. Designated **Catalog V3**, this new API will allow more fine-grained control of your store,
as well as much better performance.

Unfortunately, not every store will be able to take advantage of this new API right away. Because of this, to use the Catalog API, services will need to first check which version of the Catalog is being used on a specific site.
In order to determine which API to use, it is important to call the [`getCatalogVersion()`](https://www.sbdautomotive.com/ja/wg-cgi/dev.wix.com/docs/sdk/backend-modules/stores/catalog-versioning/get-catalog-version) endpoint at the beginning of each flow.

### Catalog Webhooks/Events
V1 Domain events will be sent for all updates to the Catalog, even for sites using the V3 catalog. Each event has a new `CatalogVersion` field. <br>
This field can take the values `V1_CATALOG` or `V3_CATALOG`. This data can be used instead of calling the Versioning API.

## Before you begin
It’s important to note the following points before starting to code:
* The site owner must have the Wix Stores app installed.
* Your app must have the SCOPE.STORES/CATALOG_READ permission

## Terminology
1. **Catalog V1**: Original API for Wix-Stores.<br>
Eventually all sites will move off this version, but some stores will stay in this version for a while yet. Read more [here](../catalog/introduction)
2. **Catalog V3**: New API for Wix-Stores. Once original API is deprecated, this will be the new standard for Wix-Stores. Read more [here](../catalog-v3/products-v3/introduction)

---
## Notes
- The [`getCatalogVersion()`](https://www.sbdautomotive.com/ja/wg-cgi/dev.wix.com/docs/sdk/backend-modules/stores/catalog-versioning/get-catalog-version) endpoint takes no parameters. All necessary information is contained within your `AUTH` header.
- Once a store has been upgraded to `CATALOG_V3`, it will not be downgraded to `CATALOG_V1`
- Changing catalog versions is a once-in-a-lifetime event for a given store (site). One call to this endpoint will suffice for most catalog flows.


To use the CatalogProvision API, install the `@wix/stores` package using npm or Yarn:
  ```console
npm install @wix/stores
```

or

```console
yarn add @wix/stores
```

Then import `{ catalogProvision }` from `@wix/stores`:

```js
import { catalogProvision } from '@wix/stores'
```
  

stores_catalog-provision

The version of Stores Catalog installed on a site.

catalogVersion

Version

getCatalogVersion( )