Collections are browsable product categories that help customers navigate your store. They are organized per market, support up to three levels of nesting, and have their own SEO settings and visibility controls.
Opening collections
- Go to Products.
- Click the Collections button in the top action bar.
The Collections page shows a market selector at the top. Everything you see and edit applies only to the currently selected market.
Market scope
Collections are per market. A collection created for one market does not automatically appear in another market. When you assign a product to collections (in the product editor's Collections tab), you choose which market's collection list to assign from. If your store has multiple markets, you maintain each market's collection list independently.
Collection hierarchy
Collections support three levels:
- Top-level collections: Up to 10 per market.
- Subcollections: Up to 10 per top-level collection.
- Specific collections: Up to 15 per subcollection.
Nesting lets you build structures like: Clothing → Women → Dresses.
Collection fields
Each collection at every level has the following fields:
- Name: Required. Maximum 50 characters. Must be unique among collections at the same level, compared without regard to letter case. For example, two top-level collections cannot both be named "Sale".
- Description: Optional. Maximum 255 characters. A short text description of the collection.
- Image: Optional. An image from your media library. The image must belong to your store. Used as the collection cover image on collection pages.
SEO fields
- Meta title: Required. Maximum 255 characters. The browser tab title and search engine headline for the collection page.
- Meta link: Required. The URL slug for the collection page. Maximum 255 characters. Allowed characters: lowercase letters, digits, Arabic letters (أ–ي), and hyphens. Must be unique across all collections in the same market.
- Meta description: Optional. Maximum 160 characters. The description shown in search results.
- Meta keywords: Optional. Maximum 255 characters.
Visibility and indexing
- Publish: When turned on, the collection is visible to customers who reach it via URL. When turned off, the collection URL is inaccessible. Default: off.
- Hide: When turned on, the collection is excluded from store navigation and search, but remains accessible via direct URL if it is also published. Default: off.
- Visibility on search engines: When turned on, search engines can index this collection. Default: off.
In the product edit form's Collections tab, collections that are unpublished show an eye-slash icon, and collections with Hide turned on show a store-slash icon, so you can see their status at a glance before assigning them.
How saving works
Collections are saved as a complete snapshot. When you click Save on the Collections page, the entire collection tree for the selected market is submitted. Any collection that existed before but is absent from the new submission is permanently deleted along with its product assignments. This means:
- If you accidentally remove a collection from the list before saving, it and all its product assignments are permanently deleted.
- Reordering collections in the editor and saving stores the new display order.
Assigning products to collections
Open a product's edit form, go to the Collections tab, choose the market, and select one or more collections from the list. You can assign a product to multiple collections at any level of the hierarchy for each market. Changes take effect when you save the product.
Things to watch out for
- Collection names must be unique at each sibling level. Two top-level collections both named "Sale" will fail on save. Uniqueness is not case-sensitive.
- URL slugs must be unique within the same market across the entire collection tree, not just within one level. Two collections in the same market with the same slug are rejected.
- Saving the Collections page overwrites the entire market's collection tree. If a team member saves at the same time, the last save wins.
- Deleting a collection (by removing it from the list and saving) removes all product–collection assignments for that collection. The products themselves are not deleted. They just lose the collection tag.
- Collections in one market are not visible in another market's collection list. If you need the same structure in multiple markets, you must recreate it in each market's Collections page.