Connect to TMXIO

Outcome

You will connect the WordPress Lens for WordPress plugin to your TMXIO workspace, understand what “connected” means, and pick the right connection method for your account.

Prerequisites

• The Lens plugin is installed and active — see Install and Activate.
• You can sign in to TMXIO with an account that has access to the workspace this site should belong to.
• Or, for legacy setups, you have a workspace token issued by TMXIO for this site.

Account-based connection vs workspace token

If your TMXIO workspace was created after 2024, use account-based connection. Workspace tokens are kept for legacy installs and bulk-provisioned agencies. New customers should not need to manage tokens by hand — pick the account flow first and only fall back to a token if your workspace specifically requires it.

Connect the plugin

Account-based (recommended)

1. In WordPress admin, open Lens in the sidebar and scroll to the Connection settings section.

2. Click Connect to TMXIO. A new tab opens to the TMXIO sign-in flow. Sign in with the account that owns or has access to the target workspace.

3. When prompted, approve the connection request for this WordPress site and select the workspace Lens should sync with. TMXIO redirects you back to WordPress and the plugin moves into a connected state.

Workspace token (legacy)

1. In TMXIO, open the workspace settings for the workspace that should own this site, then copy the Lens workspace token value.

2. Back in WordPress admin, open Lens → Connection settings, choose Use a workspace token, and paste the token into the input.

3. Click Save. The plugin validates the token against TMXIO and moves into a connected state.

Keep tokens out of source control

Workspace tokens grant Lens write access to your workspace. Do not commit them to a repository, paste them into a public ticket, or share them in chat. If a token leaks, rotate it from TMXIO immediately.

Confirm the connected state

After a successful connection, the Lens admin page should:

• No longer display the “Not connected” warning banner at the top of the page
• Show a success-styled indicator next to Connection status
• Display the connected workspace name and last sync time
• Allow widget, audience, layout, and theme settings to be saved without an error

If any of these are missing, see Sync Status and Errors or Troubleshooting.

What “connected” means

A connected plugin can:

• Push WordPress-side configuration (widget on/off, audience, layout, theme) into TMXIO
• Receive any TMXIO-side changes that affect what the widget does on this site
• Participate in normal TMXIO Lens reporting and feedback workflows for this site

A disconnected plugin still installs and renders settings, but its widget will not appear on the site and changes will not sync.

What success looks like

• The plugin shows a connected state with the correct workspace name.
• Lens settings save without errors and the last sync time updates.
• You are ready to enable the widget and pick an audience — see Enable Widget and Audience.