📋 Overview
If you see an error when publishing or uploading a blog post through the Search Atlas WordPress plugin, the cause is almost always a connection or authentication issue between Search Atlas and your WordPress site. The most common reason is a missing or incorrect Search Atlas API key or a failed one-click authentication. This guide walks you through fixing the error and restoring the plugin connection.
❓ Why This Error Happens
The WordPress plugin connects to your site using a Search Atlas API key or one-click authentication rather than a WordPress username and password. If the API key was never generated, was entered incorrectly, or your hosting environment blocks the connection, uploads will fail. Common error messages reported by users include "Could not publish to WP page" and a rest_forbidden error, both of which usually point to the same underlying connection or permission problem. Common triggers include:
- No Search Atlas API key has been generated or one-click authentication has not completed.
- A security plugin or firewall is blocking the WordPress REST API.
- Your WordPress user role does not have permission to publish posts.
🔑 Step 1: Create a WordPress Application Password
Application Passwords are built into WordPress 5.6 and later. To create one:
- Log in to your WordPress admin dashboard.
- Go to Users > Profile (or Users > All Users and select your account).
- Scroll down to the Application Passwords section.
- Enter a name you will recognize, such as Search Atlas, and click Add New Application Password.
- Copy the generated password exactly as shown, including the spaces. WordPress only displays it once.
Paste this password into the Search Atlas plugin connection settings along with your WordPress username and site URL.
🔍 Step 2: If You Cannot Find the Application Password Option
If the Application Passwords section does not appear on your profile page, work through the checks below.
🔒 Confirm your site uses HTTPS
WordPress hides the Application Passwords feature on sites that are not served over a secure (HTTPS) connection. Make sure your site loads with https:// and has a valid SSL certificate. Once HTTPS is active, refresh your profile page and the section should appear.
🔄 Check your WordPress version
Application Passwords require WordPress 5.6 or higher. Go to Dashboard > Updates to confirm your version and update if needed.
🛡️ Look for a security plugin disabling the feature
Security plugins such as Wordfence, iThemes Security, or Solid Security can disable Application Passwords or block the REST API. Temporarily review these settings:
- Find any option labeled "Disable Application Passwords" and turn it off.
- Make sure the WordPress REST API is not blocked or restricted to logged-in users only.
👤 Confirm your user role
You must be logged in as an Administrator (or a user with publishing rights) to see and use Application Passwords. Editor and lower roles may not have access. A rest_forbidden error when publishing is a strong sign that the connected user lacks the required permissions or that the REST API is being blocked.
🔌 Step 3: Reconnect the Plugin
After creating a valid Application Password, reconnect your site:
- Open the Search Atlas WordPress integration settings.
- Re-enter your WordPress site URL, username, and the new Application Password.
- Save and run a test connection.
- Try uploading your blog post again.
⚠️ Still Getting an Error?
If uploads still fail after completing the steps above, check the following:
- Site URL format: Enter the full URL including https:// and no trailing slash.
- Hosting firewall: Some managed hosts block external API requests. Ask your host to allow REST API access for trusted services.
- Caching: Clear your WordPress and server cache, then try again.
- Permalinks: Go to Settings > Permalinks and click Save once to refresh REST API routes.
- Existing posts: When updating or re-syncing a post that already exists in WordPress, make sure the article has an assigned author and a selected website, as these are required before an existing post can publish.
- Plugin version: Update the Search Atlas WordPress plugin to the latest version. Recent updates improved WordPress REST API error handling and fixed publish failures that occurred when WordPress returned an empty response.
🙋 Need More Help?
If the error continues, contact the Search Atlas support team. Please include the exact error message, your WordPress version, the name of any active security plugins, and a screenshot of your plugin connection settings. This information helps us resolve your issue faster.