# 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-06-16

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

> Control how Starshipit uses the Product Catalogue to populate product data during order import and at checkout.

Product Catalogue settings control when and how Starshipit applies your product data to orders during import and to live rate requests at checkout. All settings are in **Settings > Product Catalogue**.

## Settings reference

| Setting | What it does |
|---|---|
| **Enable Product Catalogue for order import** | Master switch. When enabled, Starshipit uses the Product Catalogue to populate product data on matching SKUs during order import. Uncheck to disable all automatic data population. |
| **Override all values** | Replaces all product fields in incoming orders (or checkout requests) with catalogue data whenever SKUs match. |
| **Only populate missing values** | Only fills in fields that are empty in the incoming order or checkout request. Existing values are not overwritten. |
| **Add items when importing orders** | Automatically creates a new Product Catalogue entry for any SKU in an imported order that doesn't already exist in the catalogue. |
| **Prevent populating if value is empty or 0** | Only populates a field if the catalogue entry contains a valid value greater than zero. Prevents blank or zero values from overwriting data during import or checkout. |
| **Use cost price for USA shipments (B2B2C)** | Uses the product's Cost Price as the declared value for shipments to the United States instead of the retail price. Requires **Override all values** to be enabled. |
| **Use on checkout** | Applies catalogue data (dimensions, weights, values) when calculating live shipping rates at checkout. Behaviour is controlled by the Override/populate-missing setting. |

:::note
**Override all values** and **Only populate missing values** are mutually exclusive — enabling one disables the other.
:::

## When to use each setting

**Override all values** is the right choice when your Product Catalogue is the single source of truth for shipping data. Any values that come in from your eCommerce platform will be replaced.

**Only populate missing values** is safer when your platform already provides some product data (like weight or dimensions) and you only want Starshipit to fill the gaps.

**Prevent populating if value is empty or 0** is useful when your catalogue may have incomplete entries — it ensures Starshipit won't inadvertently overwrite real order data with blanks or zeroes.

> Leave **Prevent populating if value is empty or 0** off if you intentionally want to overwrite existing values with blanks or zeros from your eCommerce platform.

## FAQs

**How does the "Only populate missing values" setting interact with HS Code rules?**

HS Code rules take precedence over Product Catalogue settings. If an HS Code rule applies to an order, it will override any HS code set in the Product Catalogue, regardless of the populate setting.

**Can I use the Product Catalogue on checkout for live rates?**

Yes. Enable **Use on checkout** to have Starshipit reference the Product Catalogue when calculating live shipping rates. Starshipit will use product dimensions, weights, and values from the catalogue to ensure accurate rate calculations. The Override/populate-missing setting controls whether catalogue data replaces or supplements the data provided at checkout.

**Does the B2B2C cost price setting apply to all shipments?**

No — it only applies to shipments destined for the United States. For all other destinations, the retail price is used as the declared value. **Override all values** must also be enabled for this setting to take effect.

## Related articles

* [Product Catalogue](/articles/integrations/product-catalogue/product-catalogue) — overview, use cases, and how it works.
* [Add and manage products in the Product Catalogue](/articles/integrations/product-catalogue/add-and-manage-products-in-the-product-catalogue) — add products manually or via CSV import.