Build a catalog

• Your app can make authenticated requests to the GraphQL Admin API.
• Your app has the write_products access scope. Learn how to configure your access scopes using Shopify CLI.

• You've created products and product variants in your store.

• You’ve learned about the requirements for stores to set product prices by country.

• You’re familiar with the concept of catalogs.

• Your store uses Shopify Markets and you’ve set up at least one international market.

Each market has a catalog that’s automatically created and associated with the market. The catalog determines the products that are published to customers in that market. You can use the catalogs query to retrieve the market catalogs on a store:

After you query a catalog, you can use the catalog ID to associate a price list with the catalog. The price list determines the prices that are shown to customers in that market. If a price list isn’t associated with the catalog, then customers in the associated market receive the initial variant prices converted to the market currency.

Use the priceListCreate mutation to create a new price list for the catalog. You can set the name, a percentage-based adjustment, a currency, and the ID of the catalog to associate.

Use the priceListUpdate mutation to associate an existing price list with a catalog. You can also make changes to the name, currency, or percentage-based adjustments with the priceListUpdate mutation.

Use the priceListFixedPricesAdd mutation to set a fixed price for specific product variants.

If a product variant is published to the catalog and doesn’t have a set fixed price, then its price is automatically calculated using the percentage-based adjustment that’s specified in the PriceListParent object.

To delete a partial set of fixed prices on a price list, you can use the priceListFixedPricesDelete mutation. After a fixed price is deleted, the price for the affected product variant is automatically calculated using the price list parent's percentage-based adjustment.

To delete fixed prices, you need to specify the variant ID. You can specify a maximum of 250 variant IDs in the array.

If there are specific products that must be restricted from sale in the market, then use the publicationUpdate mutation to remove them from the market’s publication. The publicationUpdate mutation allows you to republish a product to the market.

You can use the priceListDelete mutation to delete a price list so that it no longer applies for products in that market catalog. To delete a price list, you need to specify the price list ID. When deleting a priceList, all of the priceListPrices are also deleted.

Catalogs are the building blocks to control pricing and product availability around the world. Once you’ve configured a catalog, you can check what a real customer will see by passing a specific country to the publishedInContext and contextualPricing fields.

This ability to query from a specific buyer’s perspective is especially useful when customizing pricing for multi-country markets. Even when you set a fixed price in a market’s default currency, the final price a customer sees might have been converted into their local currency. Learn more about international pricing.

• Learn how to associate a price list and publication to a B2B catalog.
• Learn about automatic and manual exchange rate conversion.