## **🔍 Overview**

Search Atlas can connect directly to your WordPress site to publish and manage content. When a sync appears successful but content still fails to publish, the issue may stem from a misconfigured connection, a WordPress plugin conflict, or insufficient user permissions. This article describes the types of issues that can cause WordPress content sync and publishing failures in Search Atlas and explains what information to have ready when contacting our support team.

## **⚙️ Step 1 — Verify Your WordPress Connection**

A successful sync indicator does not always mean the connection is fully functional. Confirm that your WordPress integration is correctly configured by checking the following:

- Locate the WordPress integration settings within Search Atlas and confirm that the site URL entered matches your WordPress site exactly — including the correct protocol (**http://** or **https://**) — with no trailing slash errors.
- Re-enter your WordPress credentials or API key and save the connection to refresh it.
- If you are using the **Search Atlas WordPress plugin**, confirm it is installed, activated, and running the latest version inside your WordPress dashboard.

## **🔐 Step 2 — Check WordPress User Permissions**

Search Atlas publishes content using the WordPress user account linked during setup. If that account lacks sufficient permissions, publishing may fail even when the sync reports no errors.

- Log in to your WordPress admin dashboard.
- Locate the user account connected to Search Atlas and verify it has adequate publishing rights.
- Save any changes and attempt to publish again from Search Atlas.

## **🛠️ Step 3 — Check for Plugin or REST API Conflicts**

WordPress publishing through Search Atlas relies on the WordPress REST API. Security plugins, firewall plugins, or misconfigured server settings can block REST API requests, causing silent publishing failures.

1. In your WordPress dashboard, review your installed plugins and consider temporarily deactivating any security or firewall plugins to test whether they are blocking the connection.
2. Attempt to publish a piece of content from Search Atlas again.
3. If publishing succeeds after deactivating a plugin, re-enable your plugins one at a time to identify which one is causing the conflict.
4. Once identified, configure that plugin to allow requests from Search Atlas, then re-enable it.

You can also check whether your WordPress REST API is accessible by visiting **yoursite.com/wp-json/** in a browser. If you see a JSON response, the API is active. If you see a blank page or error, the API may be disabled or blocked — contact your hosting provider in that case.

## **🔁 Step 4 — Retry the Sync and Escalate if Needed**

After making any of the corrections above, retry publishing from Search Atlas. If the issue persists, our support team can investigate further. To help us resolve your case as quickly as possible, please have the following ready:

- The name of the Search Atlas project or workspace affected
- The WordPress site URL you are trying to connect
- A description of the exact error message or behavior you are seeing (including any error codes if shown)
- The approximate date and time the issue started
- A note on whether the Search Atlas WordPress plugin is installed and its current version

If you need further assistance, open the chat widget in the bottom-right corner of the platform and type **human teammate** to be connected with a member of our team.