# Configure Product Catalogue settings
URL: https://support.starshipit.com/articles/1781620000002-configure-product-catalogue-settings
Canonical: https://support.starshipit.com/articles/1781620000002-configure-product-catalogue-settings
Markdown: https://support.starshipit.com/articles/1781620000002-configure-product-catalogue-settings.md
Updated: 2026-10-20

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Choose when to apply catalogue data, whether to fill missing or replace existing values, and how to check the result.

Choose how Starshipit applies matching Product Catalogue data during order import, supported checkout rate requests and manual application to existing orders. Products are matched by SKU.

## Before you begin

Have Product Catalogue access and permission to edit its settings. [Add or update your products](/articles/1781620000001-add-and-manage-products-in-the-product-catalogue) before using them on orders.

## Save your catalogue policy

1. Go to **Settings > Product Catalogue**. In UI 2.0, open **[Product Catalogue settings](https://next.starshipit.com/settings/product-catalogue)**.
2. Leave **Disable the product catalogue** unchecked to enable catalogue use.
3. Choose **Only populate missing values** or **Override all values**.
4. Review the additional options available to your account in the table below.
5. Click **Save**, then reopen the page to confirm the saved choices.

Choose **Only populate missing values** when the source platform already supplies information you want to keep. Choose **Override all values** when the catalogue should replace supported item fields, including manually entered values.

## Additional options

Labels can differ between Classic UI and UI 2.0. Use the equivalent option shown in your account.

| Option | What it does |
| --- | --- |
| Add new SKUs on import | Creates catalogue products for SKUs not already in the catalogue during order import. Check these products for missing information. Applying the catalogue to existing orders does not create products. |
| **Prevent populating if value is empty or 0** / **Do not replace imported values with empty or zero product catalogue values** | Keeps blank or zero catalogue values from replacing populated order fields. Turn this off only if you intend catalogue blanks or zeroes to replace those fields in overwrite mode. |
| Use cost price for USA shipments (B2B2C) | Uses an available cost price for the item price on US shipments, subject to your fill-missing or overwrite policy. It does not apply to other destinations. |
| **Use on checkout** / **Use product catalogue on checkout** | Uses matching catalogue data in live checkout rate requests for Shopify, BigCommerce, Tiendanube and Wix. The saved fill-missing or overwrite policy also applies. This option does not enable checkout support for other platforms. |

## Verify the saved policy

Import a representative order with a matching SKU. Check the item fields you expected to populate and, in fill-missing mode, confirm existing values remain. For checkout settings, check a real cart with matching SKUs; an address-and-weight-only test does not verify item matching.

Saving settings or editing a product does not automatically refresh existing orders. In UI 2.0, follow [Apply Product Catalogue to existing orders](/articles/1792513200001-apply-product-catalogue-to-existing-orders) to update one eligible order or all active unshipped orders using the saved policy.

## FAQs

<!-- faq:start -->

<!-- faq:question -->How do catalogue settings interact with HS code rules?<!-- /faq:question -->

During import, shipping rules run after catalogue enrichment and can replace the HS code. The manual catalogue actions use your saved catalogue policy without rerunning shipping rules, so check the final HS code before printing.

<!-- faq:question -->Why did a matched item keep its existing value?<!-- /faq:question -->

Check whether **Only populate missing values** is selected. Also check the catalogue entry and the empty-or-zero safeguard: a matching SKU does not guarantee every field changes.

<!-- faq:end -->

## Related articles

- [Product Catalogue](/articles/6817931777807-product-catalogue)
- [Add and manage products in the Product Catalogue](/articles/1781620000001-add-and-manage-products-in-the-product-catalogue)
- [Apply Product Catalogue to existing orders](/articles/1792513200001-apply-product-catalogue-to-existing-orders)