> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarback-store-credit/loyalty-tiers/sync-tiers-to-customers.md).

# Sync tiers to customers

{% hint style="info" %}
**Plan:** Advanced plan and above.
{% endhint %}

{% embed url="<https://dollarlabs.neetorecord.com/watch/a61d1886ac19e0bb9518>" %}

*This article's section starts at 7:28 in the video.*

Saving tier settings doesn't reassign anyone by itself; a sync pushes your changes to every customer. This page covers when to sync, what happens while it runs, and how to confirm the result.

## Why sync is required

Day to day, DollarBack re-evaluates customers one at a time as their activity changes (an order, a referral, a new account). But when you change the rules themselves (thresholds, multipliers, tier order, the evaluation window, config assignments), every existing customer needs to be re-checked against the new ladder at once. That's the sync.

After you click **Save** on the Tiers page, a banner tells you exactly this: "Your tier settings have been saved. Sync to push the changes to all customers." Until you sync, customers keep their previous assignments, and the page flags "Sync required to apply changes."

## Run the sync

1. Go to **DollarBack admin → Tiers**.
2. Click **Sync now**.
3. The sync runs in the background across your whole customer base. While it runs, the page shows **Sync in Progress** and warns: "Tiers are being synced. Please wait before making changes." Editing is blocked until it completes so a half-applied ladder can't produce mixed results.

You don't need to keep the page open; the job continues server-side.

## How long it takes

Duration scales with your customer count. Stores with a few thousand customers typically finish within minutes; very large customer bases take longer because customers are processed in background batches. If the **Sync in Progress** state persists unusually long, refresh the page before assuming something is stuck; the status updates as the background job reports in.

{% hint style="warning" %}
Make all your tier edits first, then sync once. Each sync walks your entire customer base, and you can't edit while one is running.
{% endhint %}

## Verify a customer's tier

**In the widget (customer side).** Open your storefront signed in as the customer and open the floating widget's tier section: it shows their current tier, its multiplier badge, and progress toward the next tier. The loyalty page's tier section reflects the same assignment.

**In the admin (merchant side).** DollarBack stores each customer's tier on their Shopify customer record as a metafield (namespace `dollarback-tiers`, key `customer-tier`). Open **Shopify admin → Customers**, pick the customer, and check the metafields section of their profile to see the assigned tier value. The **Tiers Summary** on the Tiers page shows your configured ladder (conditions, multipliers, and assigned programs) for cross-checking why a customer landed where they did.

## Verify it works

Pick a customer whose spend you know puts them in a specific tier. After the sync completes, confirm both views above agree: the widget shows the expected tier, and the customer's metafield carries the same value. Then place a test order with that account and check the credit log. The earned amount should reflect the tier's multiplier.

## Common issues

* **Customer's tier didn't change after saving settings**: the sync hasn't been run (or hasn't finished). Check for the "Sync required to apply changes" banner and click **Sync now**.
* **Tier is right in admin but the widget looks stale**: storefront data can be cached briefly; hard-refresh, and if the widget itself isn't rendering see [Widget isn't showing](/dollarback-store-credit/troubleshooting-and-faq/widget-isnt-showing.md).
* **Tier is correct but an order earned at the old rate**: multipliers are snapshotted per order; orders placed before the tier change keep their original rate. See [Link cashback programs to tiers](/dollarback-store-credit/loyalty-tiers/link-cashback-programs-to-tiers.md).
* **Can't edit tiers**: a sync (or bulk code generation) is still running; wait for it to finish.

## Related articles

* [Build your tiers](/dollarback-store-credit/loyalty-tiers/build-your-tiers.md)
* [Evaluation windows](/dollarback-store-credit/loyalty-tiers/evaluation-windows.md)
* [Link cashback programs to tiers](/dollarback-store-credit/loyalty-tiers/link-cashback-programs-to-tiers.md)
* [The floating cashback widget](/dollarback-store-credit/widgets-and-storefront/the-floating-cashback-widget.md)