Sync Status and Errors

Outcome

You will read the Sync status indicator on the Lens admin page, understand what each state means, and pick the right next action — wait, refresh, reconnect, or escalate.

Where to find it

The sync indicator lives at the top of the Lens admin page in WordPress, next to Connection status and Last sync time.

Status reference

Status	Meaning	Action
Synced	The plugin and TMXIO are aligned. The latest WordPress-side settings have been pushed and TMXIO has acknowledged them. Last sync time updates after every successful save.	Continue normal use. No action needed.
Pending	A sync is in flight. The plugin has just saved settings or just connected, and is waiting for TMXIO to acknowledge.	Wait 10–30 seconds and refresh the Lens admin page. If the state stays Pending for more than a minute, treat it as Error.
Error	The plugin could not finish a sync or save. The visible error text gives the immediate cause (authentication, network, validation, or workspace permission).	Read the error text, confirm the plugin is still connected, then retry the save. If the error returns immediately, see Troubleshooting.
Not detected	TMXIO did not see the Lens runtime on the site where the plugin expected it. The widget script may have been blocked by another plugin, by a caching layer, or by a theme that strips footer scripts.	Load the site in a private window and confirm the widget actually renders. If it does not, see Troubleshooting.
Disconnected	The plugin lost its connection to TMXIO. Authentication has expired, the workspace token was rotated, or the workspace was deleted.	Reconnect from Connect to TMXIO.

Last sync time is your honest signal

When a status indicator looks fine but Lens behavior on the site does not match WordPress admin, check Last sync time. If it has not updated since you saved settings, the change has not actually reached TMXIO yet and the displayed status is stale.

Common error messages

The plugin surfaces error text from TMXIO directly. The most common ones:

• Authentication failed — the connection has expired or the token has been rotated. Reconnect.
• Workspace not found — the workspace this site was connected to has been removed or your account no longer has access to it.
• Network error — WordPress could not reach TMXIO. Often caused by an outbound firewall on the host, a misconfigured reverse proxy, or temporary downtime.
• Validation failed — a setting the plugin tried to push was rejected. Usually transient after an upgrade; retry once.

More help

If the status remains in an error state after a retry, or if the widget renders differently than the admin page shows, see Troubleshooting for symptom-grouped fixes. For environment-related questions (staging vs production, how the widget behaves across environments), see Lens environment behavior.

What success looks like

• The plugin returns to Synced within a minute of saving settings.
• Last sync time updates after every save.
• The widget behavior on the site matches the settings in WordPress admin.

Related

• Troubleshooting — symptom-based fixes.
• Connect to TMXIO — reconnect after an authentication error.
• Lens environment behavior — how Lens behaves across staging and production in the TMXIO product.