Troubleshooting
Most Xenopic hiccups come down to one of three things: a banner that isn't pushing to X, data that looks stale, or a coin balance that won't budge. Here's how to fix each — and why it usually isn't broken at all.
Your account is safe either way
Xenopic's access to X is read-only plus banner-image updates. It reads your profile to build the canvas and replaces your banner — it never posts, follows, or messages on your behalf. None of the steps below can change that.
Banner not updating
If your X banner isn't showing your latest edits, work through these in order:
- Check that the banner is enabled. An edited segment is always saved, but Xenopic only pushes it to X when that element is enabled. If the banner is paused, your changes stay in the builder and never reach X.
- Check your auto-update setting. Auto-update is what arms the automatic push after you edit. You can confirm whether it's on under Settings → Stored Profile Data, where banner updates show as Active or Paused along with the current frequency.
- Push it manually. When auto-update is off, edits won't sync on their own. Use the manual apply control in the builder to push the current banner to X right away.
- Confirm X access wasn't revoked. If you removed Xenopic from your X app permissions, it can no longer update your banner. Sign out and back in to re-authorize, then try again.
Safety net
Before experimenting, save a snapshot under Settings → Profile Backup. You can restore your original banner, bio, name, location, and more at any time.
For how scheduled pushes are timed, see Auto-updates.
Data not syncing
Widgets like Stripe MRR and GitHub activity read from connected services. If the numbers look stale, remember that everything syncs automatically in the background on a schedule — manual syncing is optional and only needed when you want an immediate update.
To force a refresh, open Settings → External Data Sync and use the Sync button on the source you care about:
| Data source | What it refreshes |
|---|---|
| Twitter Activity | Tweets, replies, and retweets |
| Twitter Followers | Your latest followers |
| GitHub Activity | Contribution history |
| Stripe Revenue | Monthly recurring revenue (MRR) |
| Velosano | Fundraising progress |
Each card shows when it last synced and a freshness dot (green = fresh, yellow = getting stale, red = never synced or very old).
If a manual sync is blocked
- "Please wait" cooldown. Manual syncs are rate-limited to protect the upstream APIs — Twitter Activity has a longer cooldown than the others. The card shows a countdown; just wait for it to finish.
- Reconnect the service. If Stripe or GitHub data still won't load, the connection may have lapsed. Re-link the service from its widget or settings, then sync again.
Profile & reach refresh for free
Your Profile & Reach numbers (followers, reach score, account age) aren't on a manual sync button — they're pulled free from your X login and refresh automatically as you use the site, at most once every few days. Reach drives which ads you can host, so it updates on its own.
Coins and widgets
Coins are build capacity, not cash — you can't buy, cash out, or transfer them. Your spendable total is simply:
available = total allowance − coins currently in use
So if "available" looks low, the coins aren't gone — they're held by your installed premium widgets. To free them up, uninstall a premium widget and its coins return to your balance instantly. Nothing is consumed, so you can experiment freely.
Coins are refundable, ads are billed by display time
Uninstalling a widget always refunds its coins. And if you host sponsorships, advertisers pay by verified display time, not clicks — with budgets that auto-cap so no one can overspend. See What are coins and How reach works.
Your full breakdown — base, bonus, referral, and per-widget costs — lives under Settings → Coin Economy. If you're over your limit, the dashboard shows a banner prompting you to uninstall widgets or upgrade your plan.
Next steps
- Account & data — manage backups, connections, and what we store.
- Auto-updates — how and when your banner pushes to X.
- Is Xenopic safe? — exactly what our X access can and can't do.