Catalogs are collections of products that can be customized for different markets, apps, or company locations. They allow you to manage product availability, pricing, and publication settings across different contexts within your Shopify store.
Catalog Fields
These are all the fields you can import or export for catalogs in Altera. Fields are grouped by category for easier reference.
General
Basic catalog information and settings.
Field | Description | Example Value |
ID | Shopify's unique catalog identifier | 7890123456 |
Command | Action to perform on this catalog row | MERGE |
Title | Name of the catalog | Holiday Market Catalog |
Type | Type of catalog context | Market |
Type Values | Specific values for the catalog type | us,ca,uk |
Status | Current status of the catalog | Active |
Top Row | Whether this is the first row for this catalog | true |
Row # | Row number in the spreadsheet | 1 |
Price List
Fields related to the catalog's price list configuration.
Field | Description | Example Value |
Price List: ID | Unique identifier for the price list | 1234567890 |
Price List: Name | Name of the price list | Holiday Pricing |
Price List: Currency | Currency code for the price list | USD |
Price List: Fixed Prices Count | Number of fixed prices in the price list | 25 |
Price List: Adjustment Type | Type of price adjustment applied | Percentage Decrease |
Price List: Adjustment Value | Value of the price adjustment | 10 |
Price List: Compare At Mode | How compare-at prices are handled | Adjusted |
Publication
Fields related to the catalog's publication settings.
Field | Description | Example Value |
Publication: ID | Unique identifier for the publication | 9876543210 |
Publication: Name | Name of the publication | Holiday Products |
Publication: Autopublish | Whether products are automatically published | true |
Products
Fields for managing products within the catalog.
Field | Description | Example Value |
Product: Command | Action to perform on the product | MERGE |
Product: Handle | Handle of the product to add/remove | blue-t-shirt |
Fixed Prices
Fields for managing fixed prices within the catalog.
Field | Description | Example Value |
Price: Command | Action to perform on the price | MERGE |
Price: Variant ID | Unique identifier for the product variant | 1122334455 |
Price: Variant SKU | SKU of the product variant | BTS-001 |
Price: Amount | Fixed price amount for the variant | 29.99 |
Price: Compare At Amount | Compare-at price for the variant | 39.99 |
Catalog Types
Altera supports the following catalog types:
Market
Catalogs that are specific to certain markets or regions.
Type Values: Comma-separated list of market handles (e.g., us,ca,uk)
App
Catalogs that are specific to certain apps installed in the store.
Type Values: Comma-separated list of app handles
Company Location
Catalogs that are specific to certain company locations for B2B customers.
Type Values: Comma-separated list of company location names
Catalog Status
Catalogs can have the following statuses:
Active: The catalog is currently active and available
Draft: The catalog is in draft mode and not yet published
Price List Adjustment Types
Price lists can apply different types of adjustments to product prices:
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
Compare At Mode
Controls how compare-at prices are handled in the price list:
Adjusted: Compare-at prices are adjusted according to the price list rules
Null Out: Compare-at prices are set to null/empty
Command Values
Catalog Commands
NEW: Create a new catalog with the provided details
MERGE: Find existing catalog and update it, or create new if not found
UPDATE: Update existing catalog (fails if catalog doesn't exist)
REPLACE: Delete existing catalog and create a new one with provided data
DELETE: Delete the existing catalog
IGNORE: Skip processing this catalog row
Product Commands
MERGE: Add product to catalog or update if already present
DELETE: Remove product from catalog
Price Commands
MERGE: Add or update fixed price for the variant
DELETE: Remove fixed price for the variant
Working with Catalogs
Creating Catalogs
When creating a new catalog, you must specify:
Title: A descriptive name for the catalog
Type: The type of catalog (Market, App, or Company Location)
Type Values: The specific markets, apps, or company locations this catalog applies to
Managing Products
Products can be added to or removed from catalogs using the Product: Handle field and appropriate Product: Command.
Setting Fixed Prices
Use the Fixed Prices fields to set specific prices for variants within the catalog context. This overrides the default product pricing.
Catalog Filters
You can use these filters to limit which catalogs are exported:
title: Filter by catalog titlestatus: Filter by catalog status (active, draft)type: Filter by catalog type (market, app, company_location)currency: Filter by price list currencycreated_at: Filter by creation dateupdated_at: Filter by last update date