Shopify

Connect and manage your Shopify store from the Control Centre card.

Last updated:

Shopify

Where to access it

  1. Open Control Centre.
  2. Find the Shopify card.
  3. Choose the sliders icon.

What you can do

  • Manage to open Shopify connection controls.
  • From Manage, choose Connect to Shopify to link your store.
  • From Manage, choose Reconnect Shopify to re-authorise an existing store connection.
  • From Manage, choose Disconnect Shopify to remove the connection.

What you will see when connected

  • Store name refreshed from Shopify when the status check succeeds
  • Connected-since timestamp
  • Connected status badge
  • Shopify pulse metrics on the same card
  • Shop average rating when Shopify review data is available

Shopify order delivery status

ChannelWeave can update Shopify Sales Orders from Shopify fulfilment webhooks:

  • fulfillments/create
  • fulfillments/update

When Shopify sends a fulfilment with status=success, ChannelWeave treats the order as Dispatched unless it is already terminal. When Shopify later sends shipment_status=delivered, ChannelWeave marks the matching Shopify Sales Order as Delivered and stores the tracking/delivery evidence in the order shipping metadata.

The Shopify app connection must include the read_fulfillments scope, and the Shopify app/webhook setup must subscribe the store to the fulfilment webhook topics. If a store was connected before this scope was requested, reconnect Shopify before relying on automatic delivery updates.

Shopify order cancellations

ChannelWeave accepts the HMAC-verified orders/cancelled webhook at POST /webhooks/shopify/orders/cancelled. The matching Shopify Sales Order is marked Cancelled, its undisbursed warehouse reservations are released, and the restored availability is propagated to linked listings.

The Shopify app/webhook configuration must subscribe each connected store to orders/cancelled; without that subscription, cancellations made in Shopify cannot release ChannelWeave reservations automatically.

Shop average rating

The Shopify card can show a Shop average rating on Control Centre.

  • If Shopify review data is available for your store, the card shows the current average rating.
  • If review data is not available yet, the card keeps the Shop average rating unavailable state.

Shopify messages in Inbox

ChannelWeave can show Shopify buyer messages in Inbox → Messages.

Before you start

  • ChannelWeave has already enabled the app-proxy feature on our side.
  • You still need one setup step per store/theme so your Contact page sends messages into ChannelWeave.
  • If you do not edit theme code yourself, send these steps to your theme developer.

Step 2: Configure your store Contact form (per store)

Use the ChannelWeave Shopify section template when the theme's standard contact form does not let you change the submit target.

Template source:

  • assets/templates/channelweave-shopify-contact-form.liquid

Setup steps:

  1. Open admin.shopify.com and choose your store.
  2. Go to Online Store → Themes.
  3. Click … → Edit code on the theme you want to update.
  4. Under Sections, click Add a new section.
  5. Name the section channelweave-contact-form.
  6. Replace the generated section code with the contents of assets/templates/channelweave-shopify-contact-form.liquid.
  7. Click Save.
  8. Go back to Online Store → Themes → Customize.
  9. In the theme editor, click the page selector at the top (often Home page) and switch to Pages → Contact.
  10. Remove or hide the standard Shopify Contact form section.
  11. Click Add section and choose ChannelWeave contact form.
  12. Keep ChannelWeave app proxy path as /apps/channelweave-contact unless your store uses a custom proxy path.
  13. Save the theme.
  14. Send a test message on your storefront Contact page.
  15. In ChannelWeave, open Inbox → Messages and confirm the message appears.

Implementation notes:

  • Shopify’s standard {% form 'contact' %} posts to Shopify’s own contact endpoint by default. On its own, it will not send messages to ChannelWeave Inbox.
  • The ChannelWeave section posts to the Shopify app-proxy path and submits the message as contact[body], which ChannelWeave ingests as a Shopify Buyer question.
  • The section includes an in-page success state for storefront customers and a no-JavaScript fallback that still posts to the same app-proxy path.

If you get stuck

Send this brief to your theme developer:

Update our Shopify Contact form to post to /apps/channelweave-contact (or our custom app-proxy path), and include message field contact[body].
Note: Shopify’s standard {% form 'contact' %} alone is not enough for ChannelWeave Inbox ingest.

Listings

Shopify draft creation is a persisted stock-first workflow.

Use Listings → Drafts → Create draft → Shopify to:

  • Choose a stock item first
  • Review recent Shopify drafts before creating another one
  • Create a stock-linked Shopify draft
  • Refine title, description, SKU, price, currency, quantity, category, and SEO fields while preserving a valid linked stock item
  • Ask Eden to draft a Shopify description from the current stock/listing facts
  • Sync images from the linked stock image manifest, upload Media library images, and reorder/remove draft images
  • Add optional variant rows by SKU with a Shopify option name/value
  • Run Validate to check stock link, content, pricing, quantity, and images
  • See an inline quantity warning when the draft quantity is higher than linked available stock
  • Publish an active Shopify product from the draft when Shopify is connected with product and inventory write scopes
  • Save, archive/unarchive, or delete an unpublished Shopify draft

You can also start from Stock items or a stock item detail page with Create drafts. Tick Shopify in the channel list to create a stock-linked Shopify draft from stock defaults; if eBay or Website are selected at the same time, ChannelWeave creates those drafts in the same run.

Publish to Shopify creates an active Shopify product via Shopify Admin GraphQL, sends the draft image manifest, applies variant option rows when present, sets tracked SKU inventory at the store's first active Shopify inventory location, records the resulting published listing, and stores the Shopify product id on the draft. Older Shopify connections must be reconnected if they were authorised before ChannelWeave requested write_products, write_inventory, and read_locations.