Shopify product update settings

Every setting on the Shopify Product Updates Configuration, for importing products from Shopify and for creating and updating products and customer price lists in Shopify.

These settings live on the Product Updates Configuration of a Shopify Integration. With Receive ticked, products are imported from Shopify into Supply Lens. With Send ticked, products (and, optionally, customer price lists) are created or updated in Shopify. Some settings apply to one direction only, as the headings below show.

Dates

Setting	What it does	Values / default	When to change it
Setup date `setupDate`	Only product changes on or after this date are processed, so historical changes aren't processed at go-live.	Date. Set automatically when the Integration is first configured.	Not normally changed afterwards.
Last import date `lastImportDate`	The import watermark. Each run only fetches product changes made after it.	Date and time. Managed by the system.	Don't edit it by hand.

Importing products: which products

Setting	What it does	Values / default	When to change it
Product statuses `productStatuses`	The Shopify product statuses to import. Products in other statuses are skipped.	List. Default `["active"]`. Values include `active`, `draft` and `archived`.	Add `draft` if products being prepared in Shopify should come through too.
Maximum products per Document `maxProductsPerDocument`	The most products in one product update Document. More products than this produce several Documents.	A number.	Set it to keep Documents a manageable size for a large catalogue.

Importing products: tax rates

These settings work out a product's tax rate when it's read from Shopify.

Setting	What it does	Values / default	When to change it
Default tax rate `defaultTaxRate`	A fixed tax rate for all products, used as the fallback when no other rate can be found.	A rate.	Set it to your standard rate.
Tax rate from collection title `getTaxRateFromCollectionTitle`	Reads the tax rate from the Shopify collection title, using `taxRateRegularExpression`.	`true` or `false`.	Turn on if you group products into collections named by tax rate.
Tax rate from tags `getTaxRateFromTags`	Reads the tax rate from the product's tags, using `taxRateRegularExpression`.	`true` or `false`.	Turn on if you tag products with their tax rate.
Tax rate pattern `taxRateRegularExpression`	The regular expression that pulls the rate out. The first capture group is the rate.	Default `^Tax\s+(\d+(?:\.\d+)?)$`, which matches `Tax 20` and takes `20`.	Change it if your collection titles or tags use a different wording.

Sending products to Shopify

Setting	What it does	Values / default	When to change it
Generate product updates `generateProductUpdates`	Creates or updates product records in Shopify.	`true` or `false`. Default `true`. When off, only the other operations (such as customer price list updates) run.	Turn off if you only want to send customer price lists.
Tag include filter `tagIncludeFilter`	When it has values, only products with at least one of these tags are created or updated in Shopify.	List of tags. Empty means all products.	Use it to limit which products are pushed to Shopify.
Update active products `updateActiveProducts`	Also updates active (published) products. By default only `DRAFT` products are updated.	`true` or `false`.	Turn on with care: it changes products customers can see.
Price key `priceKey`	Uses the price stored under this key in the product's keyed prices instead of the standard price.	A keyed price key.	Set it when Shopify should show a particular price list or pricing scenario.
Disabled field mappings `disabledFieldMappings`	A dictionary of field names to `true` or `false`. A field set to `true` isn't mapped, so it isn't overwritten in Shopify.	Dictionary.	Use it to protect fields maintained in Shopify.

Customer price lists

Setting	What it does	Values / default	When to change it
Generate customer price list updates `generateCustomerPriceListUpdates`	Updates customer-specific price lists in Shopify alongside product prices, for per-customer pricing.	`true` or `false`.	Turn on if trade customers have their own prices in Shopify.
Customer pricing identifier map `customerPricingIdentifierMap`	Maps tags to customer identifiers, to work out which Shopify customer price list belongs to each customer.	Map of tags to customer identifiers.	Set it when you use customer price lists.
Price list name pattern `customerPriceListNameIdentifierRegex`	A regular expression run on the price list name to extract the customer identifier, used with the map above.	A regular expression.	Set it when price list names contain the customer's identifier.
Price list name replacement `customerPriceListNameIdentifierReplacement`	An optional replacement string used with the pattern above to transform the matched value.	A replacement string.	Set it when the matched text needs reshaping before it matches the identifier.