Troubleshooting & FAQ

Common issues with Shopify sales channel publishing (symptoms, causes, and resolutions) plus frequently asked questions for partners and the solutions team.

This page is for channel partners and the Violet solutions team. It assumes the concepts on Sales Channel Publishing on Shopify.

Symptom → cause → resolution

The merchant connected, but their catalog is empty

Most likely cause. No products have been published to the channel yet. A new channel starts with none of the merchant's products, and this is the expected state immediately after connection.

Resolution. Walk the merchant through making their first products available, using the merchant-facing instructions in the Merchant Help Center. This is the most common ticket on this feature. Front-load it in merchant onboarding rather than handling it reactively.

The channel doesn't appear in the merchant's Shopify admin

Possible causes, in order of likelihood.

1. The merchant connected before the feature was enabled for the channel and hasn't reconnected. They keep full-catalog syncing until they re-authorize.

2. The app's channel_config extension isn't deployed and released, so Shopify rejected channel creation.

3. The app's specification handle doesn't match the handle in the deployed extension.

4. The app is missing the read_publications scope, so the publication couldn't be identified.

Resolution. Confirm the prerequisites in Enablement & Rollout, then have the merchant reconnect. Reconnecting is safe and repairs partially provisioned connections without creating a duplicate channel.

The merchant published a product, but it never arrived

Check in this order.

1. Shopify status. Draft products sync but are never available for purchase; Archived products are archived in Violet. The product must be Active.

2. Channel catalog rules. Collection filters, excluded collections, excluded tags, and excluded vendors still apply on top of publication filtering. A published product matching an exclusion rule is correctly withheld.

3. Which channel was ticked. On a store connected to several Violet channels, it's easy to publish to the wrong one.

4. Elapsed time. Sync is event-driven and usually takes seconds, but is not instantaneous.

The merchant unpublished a product, but it's still being sold

Most likely cause. A missed publication event. Violet's scheduled catalog validation does not currently re-verify publication membership, so an unpublish that occurs during an extended webhook interruption may not be reflected until the product is next modified.

Second cause. The channel's integration is reading status or available rather than publishing_status. Unpublishing updates only publishing_status, so the other two keep describing the product as it is in the merchant's store, usually still AVAILABLE, since it is still selling there.

Resolution. Trigger a product re-sync for the affected product. If it recurs across products, check that the integration reads publishing_status. See Unpublishing is an update, not a deletion.

The merchant is enabled for the feature but still syncing their whole catalog

Cause. The merchant-level setting is on, but no channel is provisioned for this particular app. This happens on stores connected to several Violet channels, where one connection is provisioned and another isn't.

Resolution. Have the merchant reconnect the affected channel. Provisioning is per connection, and reconnecting repairs the missing one without touching the others.

FAQ

Does enabling this change anything for merchants already connected?

No. Existing merchants keep full-catalog syncing until they reconnect. Enabling the feature on an app does not retroactively scope anyone's catalog.

Can we migrate existing merchants in bulk?

No. Channel creation requires Shopify permissions that a merchant only grants by re-authorizing, so migration is necessarily merchant-initiated. Plan a reconnection campaign.

Can Violet publish the merchant's products to the channel for them?

Not today. Product selection is entirely merchant-driven, and there is no backfill that publishes an existing catalog to a new channel. Merchants must make the first selection themselves.

If a merchant unpublishes everything, is their connection broken?

No. It's a valid state: an empty publication means an empty catalog. The connection stays healthy and the catalog repopulates as soon as they publish something.

Does unpublishing a product affect orders already placed for it?

No. Existing orders, fulfillment, and refunds are unaffected.

Can a merchant share different products with different Violet channels?

Yes. Each connected app has its own channel and its own product selection.

What happens if we turn the feature off for a merchant?

They revert to full-catalog syncing and their catalog expands back to their whole store. Confirm this is what the merchant expects before doing it.