## **🔗 What MetaSync does**

The WordPress plugin is listed as "Search Atlas SEO - OTTO AI SEO Automation for WordPress." Its admin menu is "Search Atlas." When the connection is healthy, Search Atlas can read the site and apply approved OTTO changes. In WordPress, a healthy connection shows "Synced," which means the heartbeat reached Search Atlas and the API key and OTTO UUID are stored. "Not Synced" means the heartbeat is not responding, and "Warning" means an API key exists but the OTTO UUID is missing. Search Atlas must also match the site to an OTTO project. If it cannot, the connection fails with "Domain not found for customer or no Otto Project found."

## **✅ Before you connect**

- You are an administrator on the WordPress site.
- The correct project is open in Search Atlas and the site URL matches the live WordPress address, including https and www if you use them.
- WordPress, your theme, and MetaSync are updated.
- Security, cache, or firewall plugins are not blocking Search Atlas from reaching the site.

## **🛠️ Connect the plugin**

1. In WordPress, go to Plugins, install "Search Atlas SEO - OTTO AI SEO Automation for WordPress" if it is not already there, and activate it.
2. Open the MetaSync settings screen.
3. You do not copy anything from Search Atlas. In WordPress, click "Connect to Search Atlas." A popup opens the Search Atlas sign-in page and sends the site address automatically. Allow popups if the window does not open.
4. Sign in through the popup and select the OTTO project for this site. Search Atlas returns the API key and OTTO UUID automatically. WordPress then shows "Synced" when the heartbeat succeeds. If the API key arrives without an OTTO UUID, it shows "Warning" and "Partial Connection (Missing OTTO UUID)." Use "Complete Authentication Setup" or "Re-authenticate with Search Atlas" to finish it.
5. Return to the same OTTO project in Search Atlas. Its installation status updates from the plugin heartbeat and from Search Atlas checks. It is not refreshed by a button. Depending on the result, it can say "OTTO SEO is Engaged (WP)," "Connecting — waiting for plugin," "Plugin Detected — Connection Needed," "Connection Incomplete," or "Connection failed."

## **📊 Confirm the sync**

Check both places, not only WordPress. In Search Atlas, the project should show a successful WordPress installation state such as "OTTO SEO is Engaged (WP)," not a pending or failed connection state. In WordPress, Search Atlas should show "Synced," not "Not Synced" or "Warning." The plugin does not display the project domain, so compare the WordPress site address with the project URL yourself. If either side disagrees, the sync is not complete.

## **🔍 Fix connected in WordPress but not working in Search Atlas**

This mismatch is usually a URL, project, or blocked-request issue. Work through these checks in order:

1. Search Atlas ignores www, the URL scheme, and a trailing slash when it matches the WordPress site to an OTTO project. The connection is rejected when no OTTO project exists for that domain, with the message "Domain not found for customer or no Otto Project found." A genuinely different hostname will not match.
2. **Use one project.** Disconnect MetaSync, then reconnect it to the project that should own this domain. Do not leave the plugin tied to an old or duplicate project.
3. **Refresh both sides.** Save MetaSync again, then reload the Search Atlas project page. Allow a short time for the status to update.
4. **Clear caches.** Purge any WordPress, plugin, or host cache, then recheck the status.
5. **Allow Search Atlas through security tools.** Temporarily pause a firewall, bot blocker, or maintenance mode and test again. If the status becomes working, add an allow rule and turn protection back on.
6. **Reinstall cleanly if needed.** Deactivate MetaSync, delete it, install the current version, activate it, and connect it again to the correct project.

## **💡 After the status is working**

Open OTTO for the project and review its recommendations. Deploy or sync only the changes you have approved. Do that from the OTTO project in Search Atlas, not from a suggestions list in WordPress. If the site's hostname changes to a domain owned by a different OTTO project, disconnect the plugin and connect it to the correct project, then confirm that WordPress shows "Synced" and Search Atlas shows the WordPress installation as engaged.

## **💬 Still not syncing**

If WordPress stays connected and Search Atlas still says not working after these checks, gather the site URL, the project name, a screenshot of the MetaSync status, and a screenshot of the Search Atlas status. If you need further assistance, open the chat widget in the bottom-right corner of the platform and send your message. A member of our support team will reply in the chat.