Skip to main content

Catalog Fields

Catalogs allow you to manage product availability, pricing, and publication settings across different contexts within your Shopify store.

Sample Files

Download sample spreadsheets to see the structure for importing catalog data. The samples reference demo products and a demo company location, so replace the handles, SKUs, and Type Values with ones that exist on your store before importing.

  • B2B percentage discount - Creates a company location catalog that lowers all prices by 15% and adds two products by handle

  • B2B fixed prices - Creates a company location catalog and sets specific prices and compare-at prices for individual variants by SKU

  • Variant-level inclusion - Adds a whole product while excluding one of its variants, and includes a single variant of a product that isn't in the catalog

General

ID

Description

Example Value

Shopify's unique catalog identifier

8901234567890

The ID field is used to identify existing catalogs for updates. When creating new catalogs, this field can be left empty and Shopify will generate a unique ID automatically.

Command

Description

Example Value

Import action

MERGE

  • MERGE: Update existing catalog or create if not found

  • DELETE: Remove the catalog from your store (will skip if catalog doesn't exist)

  • NEW: Create catalog only (will skip if catalog exists)

  • REPLACE: Delete existing catalog and create new one

  • IGNORE: Skip this catalog row during import

Title

Description

Example Value

Name of the catalog

Holiday Market Catalog

The main catalog title displayed throughout your store administration.

Type

Description

Example Value

Type of catalog context

MARKET

  • MARKET: Catalogs specific to certain markets or regions

  • APP: Catalogs specific to certain apps installed in the store

  • COMPANY_LOCATION: Catalogs specific to company locations for B2B customers

Type Values

Description

Example Value

Specific values for the catalog type

us,ca,uk

Comma-separated list of specific identifiers that this catalog applies to:

  • For MARKET type: Market handles (e.g., us,ca,uk)

  • For APP type: App handles

  • For COMPANY_LOCATION type: Company location names

Status

Description

Example Value

Current status

ACTIVE

  • ACTIVE: The catalog is currently active and available

  • DRAFT: The catalog is in draft mode and not yet published

Top Row

Description

Example Value

Whether this is the first row for this catalog

TRUE

  • TRUE: This is the first row for this catalog object

  • FALSE: This is a continuation row for the same catalog

Used internally for grouping multiple rows together into a single catalog.

Row

Description

Example Value

Row number in the spreadsheet

1

Sequential number identifying the position of this row in the import spreadsheet.

Price List

Price List: ID

Description

Example Value

Unique identifier for the price list

1234567890

The Shopify ID of the price list associated with this catalog.

Price List: Name

Description

Example Value

Name of the price list

Holiday Pricing

Descriptive name for the price list used within this catalog.

Price List: Currency

Description

Example Value

Currency code for the price list

USD

Three-letter ISO currency code (e.g., USD, EUR, CAD) for all prices in this price list.

Price List: Fixed Prices Count

Description

Example Value

Number of fixed prices in the price list - Export only

25

Total count of product variants with fixed prices defined in this price list. This field is export-only and cannot be imported.

Price List: Adjustment Type

Description

Example Value

Type of price adjustment

PERCENTAGE_DECREASE

  • PERCENTAGE_DECREASE: Reduce prices by a percentage

  • PERCENTAGE_INCREASE: Increase prices by a percentage

  • FIXED_AMOUNT_DECREASE: Reduce prices by a fixed amount

  • FIXED_AMOUNT_INCREASE: Increase prices by a fixed amount

When creating a new price list, Shopify requires an adjustment. If you only set fixed prices and leave the adjustment columns blank, Altera creates the price list with a neutral 0% adjustment, so your fixed prices apply as-is.

Price List: Adjustment Value

Description

Example Value

Value of the price adjustment

10

The percentage or fixed amount value for the price adjustment. For percentage adjustments, use whole numbers (e.g., 10 for 10%). For fixed amounts, use decimal values in the price list currency.

Price List: Compare At Mode

Description

Example Value

How compare-at prices are handled

ADJUSTED

  • ADJUSTED: Compare-at prices are adjusted according to the price list rules

  • NULL_OUT: Compare-at prices are set to null/empty

Publication

Publication: ID

Description

Example Value

Unique identifier for the publication

9876543210

The Shopify ID of the publication associated with this catalog.

Publication: Name

Description

Example Value

Name of the publication

Holiday Products

Descriptive name for the publication channel used within this catalog.

Publication: Autopublish

Description

Example Value

Whether products are automatically published

TRUE

  • TRUE: Products added to this catalog are automatically published to the publication channel

  • FALSE: Products must be manually published to the publication channel

Products

Product: Command

Description

Example Value

Action to perform on the product

MERGE

  • MERGE: Add product to catalog or update if already present

  • DELETE: Remove product from catalog

If the row also has a value in the Product: Variant ID or Product: Variant SKU column, the command applies to that single variant instead of the whole product. MERGE includes the variant in the catalog and DELETE excludes it while the rest of the product stays available.

Product: Handle

Description

Example Value

Handle of the product to add/remove

blue-t-shirt

The URL-friendly identifier of the product to include in or remove from this catalog. On variant rows the handle is optional, because the variant ID or SKU already identifies the product.

Product: Variant ID

Description

Example Value

ID of a single variant to include or exclude

1122334455

When this column has a value, the row's Product: Command applies to just this variant's availability in the catalog instead of the whole product. Exports list each excluded variant as a row with a DELETE command, so re-importing an export unchanged makes no changes, and changing a DELETE to MERGE re-includes that variant.

If MERGE variant rows reference a product that is not in the catalog yet, the product is added to the catalog with only the listed variants included. A whole-product MERGE row takes precedence: if the same file also adds the product itself, the product is included with all of its variants, and any DELETE variant rows then exclude specific variants. To include only some variants of a new product, either list just the wanted variants as MERGE rows without a whole-product row, or add the whole-product row plus DELETE rows for the variants to exclude.

A whole-product DELETE row also takes precedence: if the same file removes the product from the catalog, variant rows for that product are skipped with a warning instead of re-adding it.

Product: Variant SKU

Description

Example Value

SKU of a single variant to include or exclude

BTS-001

Works the same way as Product: Variant ID but identifies the variant by its SKU. If both columns have a value, the ID is used. If your store has duplicate SKUs, add the Product: Handle column to the row so the variant is matched within the right product, or use the ID instead.

Fixed Prices

Price: Command

Description

Example Value

Action to perform on the price

MERGE

  • MERGE: Add or update fixed price for the variant

  • DELETE: Remove fixed price for the variant

Price: Variant ID

Description

Example Value

Unique identifier for the product variant

1122334455

The Shopify ID of the product variant to set a fixed price for within this catalog.

Price: Variant SKU

Description

Example Value

SKU of the product variant

BTS-001

The stock keeping unit (SKU) of the product variant. Can be used as an alternative to Variant ID for identifying the variant.

Price: Amount

Description

Example Value

Fixed price amount for the variant

29.99

The specific price to charge for this variant within this catalog context, in the currency specified by the price list.

Price: Compare At Amount

Description

Example Value

Compare-at price for the variant

39.99

The "was" or "compare at" price to display alongside the fixed price, typically used to show savings or discounts.

Export Filters

You can use these filters to limit which catalogs are exported:

  • title: Filter by catalog title

  • type: Filter by catalog type (MARKET, APP, COMPANY_LOCATION)

  • status: Filter by status (ACTIVE, ARCHIVED, DRAFT)

  • id: Filter by catalog ID

Set type to COMPANY_LOCATION to export only B2B catalogs. The id filter accepts a comma-separated list to export a specific set of catalogs in one job.

Did this answer your question?