The Clariti WordPress plugin lets Clariti know when you publish, update, or delete a post. When it is not connected, Clariti cannot keep your posts in sync. This article explains the connection errors you might see and how to fix them.

You are in the right place if you see any of these:

The most common cause by far is a firewall, security plugin, or Cloudflare blocking Clariti's requests to your site. If you are not sure where to start, start with Step 1 below.

1. In Clariti, click Settings.

2. On the WordPress card, click the ... menu and choose Test Connection.

You will see "Attempting connection..." and then either a success message or an error with a code. Only the site owner can run the test.

"Forbidden" (Code: 403)

Something in front of WordPress turned Clariti away before the request reached your site. The plugin itself never sends this error. Allow Clariti through your firewall and security tools (Step 1), then test again.

"Clariti WordPress plugin not found." (Code: clariti/plugin-not-found)

Clariti could not find the plugin on your site. It may be deactivated, deleted, or out of date, or something may be blocking the plugin's address on your site. Make sure the latest version of the plugin is installed and active, then check that your API key is saved in the plugin settings. If that does not help, regenerate your key (Step 2).

"Clariti WordPress plugin not connected." (Code: clariti/plugin-not-connected)

The plugin has not finished connecting with your current API key. This is common right after you regenerate a key. Paste the API key from Clariti into the plugin settings in WordPress and save. If it still will not connect, regenerate your key (Step 2).

"The API key values do not match." (Code: clariti/plugin-key-mismatch)

The key saved in WordPress is different from the key Clariti has for your site. Copy the key from the WordPress card in Clariti and paste it into the plugin settings exactly, with no extra spaces. If you continue to have issues, regenerate your key (Step 2).

"Plugin signature verification failed." (Code: clariti/plugin-invalid-sig)

The plugin and Clariti no longer agree on the secret they use to trust each other. This usually happens after the plugin is reinstalled. Clear the plugin's saved secret and regenerate your key (Step 3).

"Clariti is missing the site API key." (Code: clariti/plugin-key-missing)

Your site does not have an API key in Clariti. Use Regenerate API Key in the WordPress card menu to create one, then add it to the plugin.

"An unspecified error occurred."

Clariti could not tell what went wrong. Try Steps 1 and 2. If the error comes back, email us with a screenshot.

You may also see a status message on the WordPress card without running a test:

You may have been told to visit https://yourdomain.com/wp-json to check that your REST API works. That test regularly gives a false pass.

Most firewall and bot protection rules let real browsers through and block automated, server-to-server traffic, which is exactly what Clariti is. So /wp-json can load perfectly for you while Clariti gets a 403 on the same address. If your browser test passes but Clariti still reports a 403, trust the 403 and keep going.

Clariti connects to your site from one static IP address: 35.192.123.62. Add it to the allowlist anywhere that could be blocking it:

If you use Cloudflare, create a custom rule that skips Cloudflare's security checks for 35.192.123.62 (Security > WAF > Custom rules), then turn off Bot Fight Mode (Security > Bots). How to Set Up Cloudflare to Work with Clariti walks you through both with screenshots.

Cloudflare settings are separate for each domain. If you run more than one site and one connects while another does not, the working site's settings are probably already correct. Compare the two and match them.

Once Clariti is allowed through, run Test Connection again. If it still fails, go on to Step 2.

1. In Clariti, go to Settings. On the WordPress card, click the ... menu and choose Regenerate API Key under Danger zone, then confirm.

2. Copy the new key exactly as shown, with no extra spaces.

3. In WordPress, open the Clariti plugin settings (Plugins > Installed Plugins, then Settings under Clariti).

4. Paste the new key and save.

5. Back in Clariti, click Test Connection.

If something is still blocking Clariti, a new key will not help and you will see the same error again. Make sure Step 1 is done first.

For the full setup steps, see How to Install and Connect the Clariti WordPress Plugin.

If you see "Plugin signature verification failed," or Step 2 did not work, clear the secret the plugin saved in WordPress so it can start fresh.

1. While logged in to WordPress, go to https://yourdomain.com/wp-admin/options-general.php?page=clariti&advanced=true, using your own domain.

2. Click Clear Secret.

3. In Clariti, regenerate your API key (Step 2).

4. Paste the new key into the plugin settings, save, and click Test Connection in Clariti.

A fresh install can clear out old settings that are getting in the way.

1. In WordPress, deactivate and delete the Clariti plugin.

2. Install it again from Plugins > Add New Plugin and activate it.

3. In Clariti, regenerate your API key. Do not reuse your old key. For security, Clariti rejects a key that was already connected to an earlier install, and you may see a "Cannot modify secret" error.

4. Paste the new key into the plugin settings, save, and click Test Connection in Clariti.

Email us at [email protected] and include:

We will take a closer look and help you get connected.