Skip to content
Docs

Troubleshooting connections

How to fix a WordPress, Shopify, Google or Bing connection that stops answering in RankX AI, symptom first. Every message names its cause and its fix.

Start with what RankX AI actually said. Every unavailable state in RankX AI names its own cause and its own fix, because a broken connection and a connection reporting real zeros would otherwise look identical. A refusal means RankX AI declined to answer; a zero means it answered and the answer was none.

Find your symptom below.

Google: why does a Traffic screen say there is no data?

The Google connection is in a state that cannot report yet, and the screen says which. Only a connected, synced connection returns figures.

What the Traffic screen saysWhat has happenedWhat to do
"Search Console not connected" (or Google Analytics)No connection exists for this WebsiteConnect it in Settings, then Integrations
"needs reconnecting", marked Access revokedGoogle stopped accepting the access, or several syncs in a row failedReconnect it. RankX AI shows when it last synced successfully
"is connected", marked First sync pendingConnected, and the first sync has not finishedWait for the first sync, then look again
Figures, or "No activity in this period"Synced at least onceNothing. An empty range now really is a quiet period

RankX AI never prints a zero for the first three, because "no traffic" and "we cannot see your traffic" are different facts and only one is about your website. Every state is explained in why traffic data is missing.

Google: why is the last day or two missing?

That is Google's delay, not RankX AI's sync. Google publishes Search Console data about two days after the fact, so a healthy connection has nothing for yesterday yet.

RankX AI's rolling windows end three days before today, so those days never read as a decline. If you quote a figure from the last few days, quote it as provisional.

Google: what if it is connected but no property is selected?

Choose the property, because waiting will never fix it. Open Settings, then Integrations, and press Select property on the Search Console or Analytics card. RankX AI reports this state on its own so it never looks like "wait for the sync".

Google: what do I do when it needs reconnecting?

Reconnect it with the same Google account, and the data comes back with its history intact. Open Settings, then Integrations, and reconnect the card that needs it. Nothing is wrong with your Google account.

Reconnecting with a different Google account, or choosing a different property, replaces the old data with that property's history. Traffic covers both Google connections and every screen they feed.

WordPress: why is the connection refused at setup?

If one-click approval is not offered, the site does not show WordPress's approval screen. WordPress offers it only over HTTPS, and a host or security plugin can switch it off.

Check the site URL and item 4 below. Entering an Application Password by hand is offered beside one-click on every site.

If you pasted an Application Password, work through these in order, most common first:

  1. Check the username. Use the WordPress username shown on your profile, for the same account the Application Password was created on.
  2. Check the whole password was copied. WordPress shows it once, in groups of four characters; it works with or without the spaces.
  3. Check the REST API is reachable. Open https://your-site/wp-json/ in a browser. If it does not return JSON, a security plugin or server rule is blocking it, and that has to be fixed on the site first.
  4. Check Application Passwords are enabled. WordPress offers them over HTTPS, and some security plugins switch them off. If the section is missing from your WordPress profile, that is the cause.
  5. Check the site URL. Use the https:// address WordPress itself is installed at, including www if that is what it uses.

WordPress: why will a page not save?

The message names which of three cases you are in:

  • The page is built with a protected page builder (Elementor, Divi, WPBakery and similar). Its layout lives in builder data, so no tool can edit the body, and every attempt is refused rather than half-applied. Edit it in the builder.
  • The page is built with a block-based builder, which takes targeted text patches and adding or removing a block, but not a whole-body replace. Each of those edits has to be asked for explicitly.
  • The body was too long to read in one go. A truncated body says so, and a whole-body write is never sent back from a truncated read, because it would delete the part that was not read. Use a targeted patch instead.

WordPress: why are the SEO fields not writable?

It depends on your SEO plugin, and RankX AI tells you which reason applies. The quickest fix for every case is the optional RankX AI plugin, which writes the SEO title and meta description through every major SEO plugin.

See the RankX AI plugin. Without it:

  • Rank Math and SEOPress do not expose their fields to the WordPress REST API by default. A registration snippet makes them fully writable, and RankX AI hands you one with your site's own field names in it.
  • Yoast SEO exposes them per content type, so posts can be writable while pages are not on the same site.
  • All in One SEO keeps its fields in its own database tables, so RankX AI writes them through the RankX AI plugin and refuses without it rather than appearing to succeed.

If a site was writable before and is not now, RankX AI names that as a regression. The usual cause is a plugin update or a changed setting, and the first move is finding what removed it.

WordPress: why does the live page look unchanged after a write?

Almost always a page cache. RankX AI verifies a write by re-reading the object through the REST API, which confirms the database changed. A cache in front of your site can still serve the old version.

RankX AI adds a note saying exactly this to every successful content and SEO write. Purge the cache and check again.

WordPress: what does an unverified write mean?

RankX AI could not confirm the change by reading it back, so it does not report success. The write may have landed; RankX AI is telling you it cannot prove it.

Check the object in wp-admin. If it changed, the read-back was blocked, usually by a cache or a security rule on the REST API. If it did not, a plugin accepted the request and discarded it, which is exactly the case this check exists to catch.

WordPress: why did a block lose its layout after an edit?

WordPress discards a block's settings on save when they cannot be parsed, while keeping the block and its content. On a builder block those settings often hold the identifier its styles are keyed to, so the page keeps every word and loses its look.

RankX AI guards against this twice: it warns before the write when a block's settings will not parse, naming the block and the error, and it compares settings after the write and reports any that were lost. If you see either warning, do not apply the change.

Shopify: how do I fix a store connection?

A Shopify store connects through the RankX AI app from the Shopify App Store, so there are no credentials to manage. If the app says your store is not connected, close it and open it again from your Shopify admin. The Shopify app troubleshooting guide covers each message.

A store that connected to the web app earlier with its own custom app keeps working. If that connection reports no permissions, uninstall its app in Shopify admin under Settings, then Apps, install it again from a released version in the Dev Dashboard, then press Test on the Shopify connection in RankX AI. New stores use the App Store app.

Shopify: what does "not confirmed" mean?

It is not a failure, and it is not a success either. RankX AI reads the object back after every change and compares it with what it sent. "Sent, but not confirmed" in the web app, or "Saved, not confirmed" in the Shopify app, means the comparison did not match: usually the change landed with a small difference, occasionally it did not land at all.

Open the object in Shopify and look. RankX AI does not guess between the two, because reporting a landed change as failed, or a failed one as landed, is worse than saying which question is open.

If a redirect is reported as having no effect, that is correct: Shopify only follows a redirect when the original address is genuinely gone, and deletes it by itself when that address works again.

Bing: why is there no data on the Bing screen?

Bing Webmaster Tools is a separate connection from Google, so one working tells you nothing about the other. Check the Bing card in Settings, then Integrations, and make sure a verified Bing site is chosen. Every Bing state is in why traffic data is missing.

This matters beyond traffic: Microsoft Copilot grounds its web answers in Bing search, so a page Bing cannot read is a page Copilot cannot cite.

MCP: why is a tool missing rather than failing?

The token does not carry the tool's scope. A token's scopes are fixed when it is issued, and a tool outside them is not listed and not callable, so the fix is to issue a new token with the scope.

WordPress and Shopify tools need the publish scope, WooCommerce product tools need commerce, and site settings need site_admin. A token with only read, write or spend reaches none of them.

Every Shopify tool needs publish, including the three that only read. See MCP authentication.

What if I am still stuck?

Two things make a support conversation short: which Website you are on, and the exact message you saw. Every refusal in RankX AI names its own cause, so quoting it usually saves a round trip. Contact support.

Questions

Will reconnecting Google lose my Search Console history?

Not when you reconnect with the same Google account: the data already collected stays. A different Google account or property replaces it with that property's history.

Can I use my email address instead of my WordPress username?

RankX AI asks for the WordPress username, and that is the safest choice. WordPress also accepts the account's email address with an Application Password, so a failure usually lies elsewhere in the list on this page.

What should I send support if I am still stuck?

The Website you are on and the exact message RankX AI showed. Every refusal names its own cause, so quoting it usually settles the question in one reply.

Last updated

Cookie settings

Choose which cookies we can use. You can change this at any time from “Cookie settings” in the footer.

Essential

Security, bot protection and remembering your choice. The site needs them to run, and they do not identify you. Always on.

Google Analytics cookies that tell us which pages are read and which links are followed, so we can improve them. Off until you switch it on.

Tells advertisers when their advert led to your visit. Includes the Meta (Facebook) pixel and the LinkedIn Insight Tag, which set cookies on this domain (LinkedIn also on linkedin.com) and can be told if you later start a trial.

More in the cookie policy and the privacy policy.