> For the complete documentation index, see [llms.txt](https://docs.zeroauthority.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zeroauthority.xyz/nova-bot/token-gated-discord-roles/syncing-and-automation.md).

# Syncing & Automation

### What Sync Does

When you run **Sync Roles** in your server, the system:

* Re-fetches current FT and NFT balances for **previously verified users**
* Compares holdings against **current role rules**
* Adds roles users newly qualify for
* Removes roles users no longer qualify for
* Updates the server’s role assignments to match on-chain reality

### What Sync Does *Not* Do

Syncing **does NOT**:

* ❌ Verify new users
* ❌ Ask users to reconnect wallets
* ❌ Assign roles to users who never verified
* ❌ Run continuously or in real time

### When You Should Run Sync

Run **Sync Roles** when:

* Users token balances have changed significantly
* You **update role thresholds**
* You **add or remove role mappings**
* You want to ensure roles reflect the **current on-chain state**

### How to Run Sync

1. Run `/roles`
2. Select **Sync Roles**
3. Wait for the confirmation message

{% hint style="info" %}
⏱️ Sync can be triggered **once every 72 hours per server**
{% endhint %}

> ⚠️ Sync affects ALL previously verified users in the server. Changes are applied automatically and cannot be undone.