Sending labels to BigCommerce
How image labels reach the image descriptions on BigCommerce, which descriptions are rewritten, and how to start a sync by hand.
Labels live in StoreSpan. To make them useful outside the dashboard, StoreSpan writes them into each image's description on BigCommerce, in a fixed form with color: and type: entries. This is the label sync.
When it runs
- In the background, shortly after you change labels.
- Once a day, for the whole store.
- When you press Sync labels with BigCommerce on a product's Images tab, or Sync all labels with BigCommerce on the Image settings page.
A large store can take a while. You can leave the page; the sync carries on.
Which descriptions are rewritten
This is the rule, exactly as the Image settings page states it:
- Every image you labelled in the app gets the description its labels make, even if its description was typed by hand.
- An image you did not label is rewritten only when its description already lists every label under
color:ortype:; then only the spelling changes, never the words. - Images with no labels stay as they are.
Hand-written captions
Once an image carries labels you set in the dashboard, its description on BigCommerce is replaced by the label text. If you rely on a hand-written caption for an image, do not label that image in StoreSpan.
Sync badges
An image card shows a badge until its labels are on BigCommerce:
- pending: the write is queued.
- A red badge with an error: the last write failed. Press Requeue write-back on the card to try again. You can list all such images with the Sync error filter on the Images page.
What the manual buttons say
- On a product: Nothing to sync right now. when every image is already up to date, or a note that N images were queued and BigCommerce gets the labels shortly.
- For the store: Sync started. BigCommerce gets the labels in the background; a large store can take a while.
The switch that controls it
The Image labels switch under Store › Settings › Writing to BigCommerce stops or starts this write-back for the store. While it is stopped, labels you set stay in StoreSpan and are sent later when you start it again. See Image settings.