Creating catalogs to use with Markets

Tip

If your store is on the Shopify Plus plan, then you can activate the new Markets functionality by using feature test drive.

A catalog is a set of products that you can select to sell to specific markets. Catalogs let you provide a tailored buying experience.

You can create catalogs, and then assign them to specific markets. There are multiple considerations when assigning multiple catalogs to markets.

Create a new catalog to use with Markets

You can create a catalog to use with markets.

When you manually set a price for a product in a catalog, this price overrides the Overall price adjustment setting. For example, you sell a product for $5.00 USD. You set the overall price adjustment for your catalog to a 10% decrease, lowering the price of your product to $4.50 USD. Then, in the Products section, you set a price of $2.00 USD for that product. The price displayed and charged to your customers is $2.00 USD, because the price of the product you manually enter a price for isn't affected by overall price adjustments.

Steps:

1. From your Shopify admin, go to Markets > Catalogs.

2. Click Create catalog.

3. In the Name section, enter a name for your new product catalog.

4. Next to the Name field, select the publishing status for your new catalog. Select Active to start using the catalog as soon as it's created, or Draft to preview the catalog before using it on your online store.

5. Optional: If the market that you want to use the catalog with has already been created, then click Add a market, and select a market to use the new catalog for. You can leave this field blank to continue setting up the catalog and assign a market later.

6. In the Pricing section, set up your price settings:

   • In the Set prices in field, select the currency for the catalog. Customers browse and pay in the currency of their market, regardless what the catalog currency is.
   • Optional: To adjust the prices of all the products in your catalog, select Increase or Decrease in the Overall price adjustment field, and then enter a percentage amount to adjust your prices by for your new catalog.

7. In the Products section, select the products to offer in your catalog:

   1. By default, all the products available in your store are included in the catalog. To exclude specific products, toggle the checkbox beside the product name, and then click Exclude from catalog. Click the search and filter icon to search for a specific products or filter your results.
   2. Optional: In the Price column, set a specific price for your products.

Assign a catalog to a market

You can assign a catalog of products to a market during market creation, or at any time afterwards.

Steps:

1. From your Shopify admin, go to Markets.

2. Click the market that you want to customize.

3. Click the + icon next to the Catalogs setting.

4. Select the catalogs that you want to add to the market.

5. Click Done.

6. In the top bar, click Save.

Note

For the product to be available on a sales channel, the product must be included in a catalog assigned to the market and made available to the channel on the Product Details page.

Considerations for assigning multiple catalogs to markets

If you assign multiple catalogs to the same market, then the following rules determine the price that's displayed to your customers on your online store:

• If the catalogs include different products, then all products from each catalog are displayed.
• If the catalogs assigned to the same market include the same product at different prices, then your online store displays the lowest price for that item.

If you assign multiple catalogs to multiple markets for the same country, then the following rules determine the price your customers view on your online store:

• If the catalogs include different products, then all products from each catalog are displayed.
• If the catalogs assigned to the markets include the same product at different prices, then your online store displays the most specific price for that item.

For example, you have a North America market with the North America catalog assigned and a Canada market with the Canada catalog assigned, the products included in either the North America or Canada catalogs are included. If a product is included in both catalogs, then the Canada catalog price is more specific.

Draft orders and catalogs

Product publishing per market doesn't apply to draft orders or when editing orders.

For example, if you have a product that is unpublished from your United Kingdom market, but you have a customer in the United Kingdom that you want to sell that product to as an exception, then you can create a draft order for them.

Editing products on an order can override the product publishing rules that you set up in international sales tools when you want to make exceptions for customers.

Online store search results

If you're using Shopify's online store search to help customers find your products, then a customer's search results include only the products that are published in their market. If your store uses a third-party search app, then you need to check with the app developer to determine whether your store search is filtered by market.

Redirection behaviour

When a customer on your online store tries to view a product that can't be sold to them in their country or region, then they're redirected to your store's home page.

For example, a customer who wants to ship their order to the United Kingdom visits your store, for which the primary market is the United States. The customer views a product that can sold only in the United States, and then they use the country selector on your store to switch to the United Kingdom. Because the product that they were viewing can't be sold in the United Kingdom, the customer is redirected to your store's home page.

Using catalog CSV files

After you create a catalog, you can export your pricing, publishing, and quantity rules data to a CSV file. You can then make changes to the CSV file and import the file to update the catalog.

Downloading a sample CSV file

You can download and view a sample catalog CSV file to use as a template.

The sample file contains example products and variants. If you use the sample file as a template, then make sure that you remove all the example products.

Description of the catalog CSV file

Note

Setting a compare-at price for products is only available if you use a CSV file. You can’t set compare-at prices in catalogs from the Shopify admin.

This table lists the fields in the catalog CSV file.

The Catalog Title field must be filled. Products and variants in the catalog can be identified with information in the SKU column. If the product doesn't have a SKU, then the product or variant must have identifying information such as Handle, Option1 Name, and Option1 Value.

The Fixed Price field must be filled for the catalog import. If Fixed Price and Compare At are both blank, then the fixed price for that product or variant is removed from the catalog.

Description of the items in the catalog export CSV.

Column	Description
Catalog Title	The name of the catalog.
SKU	The SKU of the product or variant. The SKU is used to track inventory with inventory tracking services. If the product you want to update has a SKU, then you can use it in place of other information in the CSV, such as Handle, Option1 Name, or Option1 Value.
Handle	Handles are unique names for each product. They can contain letters, dashes, and numbers, but no spaces, accents, or other characters, including periods. Handles are used in the URL for each product. For example, the handle for a "Women's Snowboard" would be womens-snowboard, and the product's URL would be https://yourstore.myshopify.com/products/womens-snowboard.
Option1 Name	If a product has an option, then the option name is listed in this column. For example, Color.
Option1 Value	If a product has an option, then the option value is listed in this column. For example, Black.
Option2 Name	If a product has a second option, then the option name is listed in this column.
Option2 Value	If a product has a second option, then the option value is listed in this column.
Option3 Name	If a product has a third option, then the option name is listed in this column.
Option3 Value	If a product has a third option, then the option value is listed in this column.
Fixed Price	The price of the product or variant. Only include the price and don't include any currency symbols. For example, 9.99. A blank field in both Fixed Price and Compare At removes the fixed price for that product or variant from the catalog.
Compare At	The Compare At price of the product or variant. Only include the price and don't include any currency symbols. For example, 9.99. A blank field in both Fixed Price and Compare At removes the fixed price for that product or variant from the catalog.
Published	To include a product in the catalog, enter TRUE in the Published column. To exclude a product from the catalog, enter FALSE. You can only include or exclude products, and can't include or exclude specific product variants. Only the first row of the product variants are reviewed for this selection.
Quantity Increment	The number of items by which the variant can be purchased, when the variant only sells in multiples of a set quantity. This field restrict customers from buying a quantity that's not in multiples of the quantity increment. To set quantity rules, you need to set a value of 1 or greater for both Quantity Increment and Minimum Order Quantity. The Maximum Order Quantity field is optional, and can be left blank. If the values for Quantity Increment, Minimum Order Quantity, and Maximum Order Quantity are all blank for the same row, then the quantity rules for that product variant are removed.
Minimum Order Quantity	The fewest number of items of the variant that a customer can purchase at the same time. To set quantity rules, you need to set a value of 1 or greater for both Quantity Increment and Minimum Order Quantity.
Maximum Order Quantity	The greatest number of items of the variant that a customer can purchase at the same time. The Maximum Order Quantity field is optional, and can be left blank.
Quantity Break 1-10	The quantity threshold for volume pricing. You can to 10 quantity breaks, which need to match up with each related price break. For example, if a customer orders 25 shirts (Quantity Break 1 value), then they pay 5.00 USD for each shirt (Price Break 1 value). If a customer orders 40 shirts (Quantity Break 2 value), then they would pay 3.50 USD for each shirt (Price Break 2 value). To add volume pricing through a CSV, the Quantity Break value needs to be a whole number with a value of 1 or greater that's equal to or greater than the minimum order quantity, and you need to have a price break value in the same numbered Price Break field. Quantity breaks are optional, and can be left blank.
Price Break 1-10	The reduced price per unit that matches with each quantity break that you set up for volume pricing. For example, if you want a customer to pay only $5.00 USD per shirt when they purchase 25 shirts or more, then the Quantity Break 1 value is 25, and the Price Break 1 value is 5.00. When you enter the price in a Price Break field, only include the price. Don't include any currency symbols. For example, 9.99. Price breaks are optional, and can be left blank.

Export and import catalogs using CSV files

You can export and import catalogs individually or in bulk using CSV files.

Export a catalog

When the export is complete, the CSV files are sent to you in an email.

Only prices for products with fixed prices are included in the exported catalog. Prices for products with a percentage adjustment aren't included.

To update a product variant in a catalog by using a CSV upload, enter the new information in one of the following column options:

• the SKU column
• the options and values columns, such as Option1 Name and Option1 Value

The Published column doesn't affect individual variants.

Export a single catalog

Export a single catalog from your Shopify admin.

Steps:

1. From your Shopify admin, go to Markets > Catalogs.

2. Click an existing catalog to export a list of your products with price adjustments applied.

3. Click Manage, and then select Export CSV.

4. Select one of the following to choose which products to export:

• All products
• Only included products
• Only products with fixed prices
• Only products with quantity rules

5. Select the format of the CSV file.
6. Click Export CSV.

Export multiple catalogs in bulk

Export multiple catalogs in bulk from your Shopify admin.

Steps:

1. From your Shopify admin, go to Markets > Catalogs.

2. Select the catalogs that you want to export.

3. Select one of the following to choose which catalogs to export:

• Current page
• Selected catalogs

4. Select one of the following to choose which products to export:

• All products
• Only included products
• Only products with fixed prices
• Only products with quantity rules

5. Select the format of the CSV files.
6. Click Export CSV.

Import a catalog

Depending on the size of the catalog, importing might take some time to complete. A notification indicates when the import is complete. You can update a single catalog or update multiple catalogs in bulk.

Update a single catalog

Update an existing catalog by importing a CSV file.

Steps:

1. From your Shopify admin, go to Markets > Catalogs.

2. Click the existing catalog that you want to update.

3. Click Adjust prices, and then select Import CSV.

4. Click Add file, or drag and drop your files to the dialog to upload.

5. Click Preview Import.

6. Review the preview to verify that your columns and data are correct, and then click Import CSV.

Update multiple catalogs in bulk

Update multiple catalogs in bulk by importing a CSV file.

Steps:

1. From your Shopify admin, go to Markets > Catalogs.

2. Click Add file or drag and drop your file to the dialog box to upload.

3. Click Preview import.

4. Review the preview to verify that your columns and data are correct, and then click Import CSV.

5. Optional: Click Close to continue working during the time the import is processing.