The Brands API allows you to create and manage brands, which can then be assigned to products using the Products API.
Brands enhance product visibility and customer engagement, making it easier for customers to find products based on their brand preferences.
This API provides all the necessary functionality to manage a bank of brands, which can be applied to products to ensure a consistent brand experience across your store.
With the Brands API, you can:
It’s important to note the following points before starting to code:
getCatalogVersion()
to get the site's Stores catalog version before using any of the Brands V3 API methods. If the site uses Stores Catalog V1, the Brands V3 API methods will not be available.To use the BrandsV3 API, install the @wix/stores
package using npm or Yarn:
or
Then import { brandsV3 }
from @wix/stores
:
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Creates multiple brands.
Brands to create.
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Deletes multiple brands.
IDs of brands to delete.
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Retrieves multiple brands by name, or creates multiple brands if those with the passed ribbonNames
don't exist.
Brand names to retrieve or create.
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Updates multiple brands.
Each time a brand is updated, revision
increments by 1.
The current revision
must be passed when updating a brand.
This ensures you're working with the latest brand and prevents unintended overwrites.
List of brands to update.
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Creates a brand.
To assign the brand to a product, include the brand.id
or brand.name
when creating or
updating a product.
Brand to create.
This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.