Metafield Sync Status
This guide explains the Metafield sync panel on a price list — how Qivra B2B Wholesale pushes your pricing rules to the storefront and checkout, and what to do when a sync fails.
What is metafield sync?
Section titled “What is metafield sync?”When you save a price list, the app compiles your rules into a compact format and writes them to a Shopify shop metafield. The storefront pricing engine and the checkout Shopify Function both read this metafield to apply your prices.
The Metafield sync panel shows the current state of that write and lets you retry or fully resync.
Sync statuses
Section titled “Sync statuses”| Status | Meaning | Action needed |
|---|---|---|
| Updating | Sync in progress | Wait — no action needed |
| Up to date | Latest rules are live on the storefront | None |
| Action needed | Last sync failed | Click Try again |
| Idle | Nothing to sync (no recent changes) | None |
Retry a failed sync
Section titled “Retry a failed sync”When the panel shows Action needed:
- Click Try again.
- The app re-attempts the metafield write.
- The status returns to Updating, then Up to date on success.
If retries keep failing, see Troubleshooting: metafield size limit or contact support with the failed-variant details from the Advanced panel.
Full resync (Advanced)
Section titled “Full resync (Advanced)”For a clean rebuild of all pricing data:
- Open Advanced in the sync panel.
- Click Refresh all prices.
This triggers a complete resync across all your price lists. Use it when:
- Prices look stale or inconsistent across products.
- You have recovered from an earlier sync failure.
- Support asks you to send a fresh state.
Refresh all prices rewrites the entire shop pricing metafield. For large catalogs this can take a few minutes.
Failed variant samples
Section titled “Failed variant samples”Inside the Advanced panel, the app lists specific variants that failed to sync last time. Include these when contacting support so the team can pinpoint the issue.
When prices don’t reflect changes
Section titled “When prices don’t reflect changes”If you saved a price list but the storefront still shows old prices:
- Confirm the sync status is Up to date (not Action needed).
- Confirm the price list is Active and within its effective period.
- Try Refresh all prices.
- Still wrong? See Troubleshooting: B2B prices not showing.
Related docs
Section titled “Related docs”- Create your first price list
- Priority, status, and effective period
- Troubleshooting: B2B prices not showing
- Troubleshooting: metafield size limit