Our first app, Migrato, is live on the Shopify App Store - free plan, no credit card. Take a look
Home / Documentation / Template Documentation
Smart Collections Import/Export

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.
i

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:

  1. Basic Columns
  2. Rules
  3. Linked Products
  4. Products Count
  5. Metafields
Migrato – Smart Collection Template Groups 1
Migrato – Smart Collection Template Groups 1
Migrato – Smart Collection Template Groups 2
Migrato – Smart Collection Template Groups 2

1. Basic Columns

These columns contain the core information used to identify, describe, configure, and publish Shopify Smart Collections.

Smart Collection Template – Basic Columns
Smart Collection Template – Basic Columns
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.

2. Rules
Smart Collection Template – Rules
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.

3. Linked Products
Smart Collection Template – Linked Products
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.

4. Products Count
Smart Collection Template – Products Count
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.

5. Metafields
Smart Collection Template – Metafields
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:

  1. Download the Smart Collection Demo CSV/XLSX file, if available.
  2. Review the Smart Collection Template Documentation.
  3. Keep the required column names unchanged.
  4. Enter the Smart Collection data according to the expected format.
  5. Ensure Smart Collection rules contain the required product column, relation, and condition.
  6. Save the file as CSV or XLSX.
  7. Upload the file to Migrato or provide its publicly accessible URL.
  8. Review the import operation before starting the job.
i

Tip: For the safest workflow, use a Migrato-generated Smart Collection export as a starting point when preparing data for a subsequent import.

Ready to run this on your own store?

Migrato's free plan handles 25 items per job - enough to follow any page in these docs end to end before you pay anything.

Free plan forever No credit card 2-minute setup Uninstall anytime