Configuration

Merchant configuration lets you change how Violet handles a merchant's shipping, inventory, and catalog behavior directly, without routing every change through Violet support. Each capability is exposed as a first-class REST resource under /merchants/{merchant_id}/*.

The guides in this section explain what each configuration capability does and how the pieces behave together. For endpoint definitions, field tables, and request examples, see the two reference pages:

• Merchant Configuration Resources covers the individual REST resources.

• Merchant Configurations covers the full configuration object, including feature flags.

Configuration is set per merchant and applies to that merchant across every channel they are connected to. There is no per-channel or per-app configuration, although a few settings can only be changed with a channel or admin token.

Configuration writes are rejected while the merchant is disabled or while their configuration is locked by Violet. Contact the Violet team if a merchant's configuration is locked.

Shipping

Shipping configuration controls which shipping methods Violet passes through to your channel for a merchant's orders.

• How Violet shipping works with the merchant's platform explains the layered model: Violet filters and supplements what the merchant's platform returns, and never changes the platform's own settings.

• Choosing which shipping rates are passed through covers the exclusion toggles for platform rates and free shipping.

• Fallback shipping methods covers the methods you define in Violet, including pricing, handles, and conditions.

• When fallback methods are used covers the toggle that holds fallback methods in reserve.

Inventory

• Inventory location filters covers choosing which Shopify locations count toward product stock levels. Shopify merchants only.

Catalog

Catalog configuration controls which products sync into the catalog, and whether the ones already there can be purchased.

• How catalog rules work explains the two rule types and the moment each one acts. Read this first. Catalog rules currently apply to Shopify merchants only.

• Availability rules covers making synced products purchasable or not.

• Exclusion rules covers stopping products from syncing in, or syncing them unpublished.

• Offer publishing and visibility covers the automatic publishing default and the visibility override that only channels can change.