Template Documentation
Smart Collection Template Documentation
Migrato uses a structured template for importing and exporting Shopify Smart Collection data.
The template defines the columns that can be used to transfer Smart Collection information between Migrato and Shopify.
You can use the template to:
-
Prepare Smart Collection data for import.
-
Understand exported Smart Collection data.
-
Modify exported Smart Collection data before re-importing.
-
Migrate Smart Collection information.
-
Maintain a consistent Smart Collection data structure.
Before preparing your file: Download the available Smart Collection Demo CSV/XLSX file or export a sample Smart Collection file from Migrato to understand the current template structure.
Smart Collection Template Structure
The Smart Collection template contains the following field groups:
- Basic Columns
- Rules
- Linked Products
- Products Count
- Metafields
1. Basic Columns
These columns contain the core information used to identify, describe, configure, and publish Shopify Smart Collections.
| Column | Description | Allowed Values / Example |
|---|---|---|
| ID | Unique Shopify identifier for the Smart Collection. | Number / Shopify Collection ID |
| Handle | URL-friendly identifier used for the Smart Collection URL. | Text — summer-collection |
| Title | Name of the Smart Collection displayed in Shopify. | Text — Summer Collection |
| Body HTML | Description of the Smart Collection, including supported HTML content. | HTML / Text |
| Sort Order | Defines the order in which products are sorted within the Smart Collection. | manual, best-selling, alpha-asc, alpha-des, created, created-desc, price-asc, price-desc |
| Template Suffix | Identifies the custom Liquid template suffix used by the collection. | Text — custom / Blank |
| Updated At | Date and time when the Smart Collection was last updated. | ISO 8601 date/time — 2026-08-13T10:30:00Z |
| Published | Indicates whether the Smart Collection is published. | true / false |
| Published At | Date and time when the Smart Collection was published. | ISO 8601 date/time / Blank |
| Published Scope | Defines the publication scope of the Smart Collection. | web / global |
| Image Src | Source URL of the Smart Collection image. | URL — https://example.com/collection.jpg |
| Image Width | Width of the Smart Collection image in pixels. | Number — 800 |
| Image Height | Height of the Smart Collection image in pixels. | Number — 600 |
| Image Alt Text | Alternative text describing the Smart Collection image. | Text — Summer Collection |
| Row # | Identifies the row number in the import/export structure. | Number — 1 |
| Top Row | Identifies whether the row is the top-level row for the Smart Collection record. | Boolean / Template control value |
Shopify defines fields such as handle, title, body_html, sort_order, template_suffix, updated_at, published_at, published_scope, and collection image properties as part of the Smart Collection resource. Supported sort-order values include manual, alphabetical, best-selling, created-date, and price-based ordering.
2. Rules
The Rules group contains the conditions used to automatically determine which products belong to the Smart Collection.
| Column | Description | Allowed Values / Example |
|---|---|---|
| Must Match | Defines whether products must match all configured rules or one or more rules. | true / false |
| Rule: Product Column | Specifies the Shopify product attribute used by the Smart Collection rule. | Example — title, vendor, type, variant_price |
| Rule: Relation | Defines the comparison relationship between the selected product column and the rule condition. | Example — equals, contains, starts_with, greater_than |
| Rule: Condition | Specifies the value that the selected product column is compared against. | Example — Nike, Shirts, 100 |
Shopify Smart Collection rules use a product column, relation, and condition. Shopify supports text-based relations such as equals, not equals, starts with, ends with, contains, and not contains, as well as numeric relations such as equals, greater than, less than, and not equals where supported by the selected rule column.
3. Linked Products
The Linked Products group contains information about products associated with the Smart Collection.
| Column | Description | Allowed Values / Example |
|---|---|---|
| Product: ID | Unique Shopify identifier of the product linked to the Smart Collection. | Number / Shopify Product ID |
| Product: Handle | URL-friendly identifier of the linked product. | Text — mens-t-shirt |
| Product: Position | Position of the linked product within the Smart Collection. | Number — 1 |
4. Products Count
The Products Count group contains the number of products associated with the Smart Collection.
| Column | Description | Allowed Values / Example |
|---|---|---|
| Products Count | Number of products currently associated with the Smart Collection. | Number — 25 |
5. Metafields
The Metafields group contains supported Shopify metafield information associated with the Smart Collection.
| Column | Description | Allowed Values / Example |
|---|---|---|
| Metafield:... | Represents a supported Smart Collection metafield configured for the store. The exact metafield key and value depend on the store configuration. | Example — custom.collection_type = seasonal |
Preparing a Smart Collection Import File
When preparing a Smart Collection import file:
- Download the Smart Collection Demo CSV/XLSX file, if available.
- Review the Smart Collection Template Documentation.
- Keep the required column names unchanged.
- Enter the Smart Collection data according to the expected format.
- Ensure Smart Collection rules contain the required product column, relation, and condition.
- Save the file as CSV or XLSX.
- Upload the file to Migrato or provide its publicly accessible URL.
- Review the import operation before starting the job.
Tip: For the safest workflow, use a Migrato-generated Smart Collection export as a starting point when preparing data for a subsequent import.