Docs

Everything you need to install Clickfade, read the report and fix what it finds. Jump to: Requirements, Install, Connect Google, Reading the report, Upgrade, Refresh tracking, AI advisor, Settings, Troubleshooting.

Requirements

  • WordPress 6.9 or newer and PHP 7.4 or newer.
  • A website that is verified in Google Search Console, as a domain property or a URL-prefix property, and a Google account that can see it.
  • A site that can make outgoing HTTPS requests (to Google and to the Clickfade service).
  • For daily updates (Pro): working WordPress background tasks. See “Daily updates do not run” under Troubleshooting.

Install the plugin

  1. Click Run free scan on the website and sign in with Google or an emailed link. No password is needed.
  2. On your account page, choose Download the plugin.
  3. In WordPress, go to Plugins, Add New Plugin, Upload Plugin, choose the zip and install it, then activate it.
  4. Open Clickfade in the admin menu. A short setup wizard starts.

Updates appear in the normal WordPress Plugins and Updates screens once the site is connected.

Connect Google and run your free scan

  1. In the wizard, click Connect Google. You are sent to Clickfade, asked to confirm which site you are connecting, and then to Google.
  2. Approve read-only access to Search Console. Clickfade cannot change anything in your Search Console account.
  3. You return to your WordPress admin. Choose the Search Console property that matches your site (the matching one is preselected).
  4. Click Run free scan. The scan runs in the background and shows its progress. Large sites can take a few minutes.

Every Search Console property gets one free scan. The report stays visible afterwards, frozen at that date. Reinstalling the plugin or changing the site address does not reset it.

What is stored, and where

  • Your Search Console data and reports stay in your own WordPress database. The Clickfade service never stores them.
  • Your Google access token is kept encrypted on your site. The Clickfade service hands out short-lived access tokens and does not keep your Google token.
  • The service stores your account email, your site address, your plan, and for the free scan only a summary: totals and your five biggest losers. That is how it knows a property has used its free scan.
  • You can disconnect at any time in Settings. That revokes the token at Google. You can also remove a site from your account page.

Reading the report

Clickfade compares the latest period (28, 90 or 180 days; 90 by default) with the period just before it. Both periods end three days ago, because Search Console data is not final before that, and both contain the same number of days. Only articles that had at least the minimum number of clicks (10 by default) in the earlier period and lost clicks are listed.

The likely cause

  • No recent visibility: Search Console reported no impressions for the page in the later period. It may have been removed, redirected or blocked, or there may simply be no data. Check the page before you act; this label is not proof that Google dropped it.
  • Lost rankings: the average position got worse by 3 or more places.
  • Less demand: impressions fell by 30 percent or more while the position held.
  • Fewer clicks per view: people still see the page but click less. A clearer title or meta description may help.

These labels follow fixed rules, listed on each card in the report. They are a starting point, not a verdict.

The article window

Click an article to see its clicks per day, the queries that lost the most clicks, and links to edit or view it. Search Console leaves out rare and private queries, so the query list is never complete. Low-traffic articles move a lot from week to week; raise the minimum clicks in Settings if the list is noisy.

Use Export CSV to take the report with you. The CSV export is also your backup of the report.

Upgrade to Pro

Pro keeps the report current and adds the tools to act on it:

  • The report updated every day, with 16 months of history and a permanent archive stored in your own database.
  • Lost queries for every article, cannibalization detection, and an Opportunities list of articles that are seen a lot but rarely clicked.
  • Refresh tracking at 30, 60 and 90 days, and the editor sidebar panel.
  • A weekly digest and drop alerts by email or Slack.
  • The AI Content Recovery Advisor (you bring your own OpenAI or Claude API key).

Click Upgrade in the plugin and choose Monthly or Annual (two months free). The checkout opens in a new tab and is handled by Paddle. When the payment goes through, Pro unlocks in the plugin within a minute, without reloading. You manage the payment method, invoices and cancellation from your account page.

If you cancel or a payment fails, your site keeps its last report, frozen at that date. The Pro archive is kept for 90 days in case you come back, and you get an email two weeks before it would be deleted. Start a plan again within that time and nothing is lost.

Refresh tracking

After you update an article, open it in the report (or in the block editor sidebar) and click Mark as refreshed. The Refreshed tab then shows the clicks in the 30, 60 and 90 days after the refresh against the same number of days before it, with the dates compared. A window shows “waiting” until it has fully passed, and “too little to tell” when there are very few clicks.

Clicks also change because of seasons, rankings and demand, so a rise after a refresh does not prove the refresh caused it. It is a measurement, not a verdict.

AI Content Recovery Advisor

An optional Pro feature. For one declining article, it reads the article and its Search Console numbers and suggests what to check first: what changed, possible explanations with a confidence level, and a short list of actions. It never edits or publishes anything and only runs when you click.

Set it up

  1. Create an API key with the provider you prefer: OpenAI or Anthropic (Claude). A ChatGPT or Claude subscription is not an API key; the API has its own billing, which you pay directly.
  2. In Clickfade, open Settings, AI Content Recovery Advisor, choose the provider and model, paste the key and click Save key, then Test connection.
  3. Turn on AI analysis, set a monthly limit, and save. Open an article in the report and click Analyze with AI.

The key is stored encrypted on your site and is never shown again. For each analysis, only that one article’s title, text, headings, SEO title and description, and Search Console numbers are sent to your provider. Nothing goes to Clickfade. Draft, private and password-protected posts are never sent. The plugin shows the tokens each analysis used; your provider’s dashboard shows the real cost.

Treat the advice as a checklist to verify. It cannot see your competitors or Google’s updates, and it does not guarantee more traffic.

Settings

  • Period: 28, 90 or 180 days to compare. Minimum clicks: ignore articles with fewer clicks in the earlier period.
  • Post types and exclusions: which content is analyzed, and categories or URL parts to leave out (use * as a wildcard).
  • Notifications (Pro): weekly digest, drop alert threshold, recipients, and an optional Slack webhook.
  • Opportunities (Pro): the minimum impressions and the click-through rate below which an article is listed.
  • AI (Pro): provider, model, key, monthly limit, and whether editors may request analyses.
  • Remove data on uninstall: deleting the plugin removes its reports and settings unless you turn this off. Provider API keys are always removed.

Troubleshooting

Google access was revoked, or I cannot connect

Click Connect Google again and approve access. If it keeps failing, check that your browser allows cookies for the Clickfade site, and that you are signed in to the Google account that owns the Search Console property.

My property is not in the list

Only properties your Google account can read appear. Add the property in Google Search Console and verify it, or connect with the account that owns it. A domain property and a URL-prefix property are listed separately.

The free scan says it was already used

Each Search Console property gets one free scan, even after a reinstall or a change of site address. The report from that scan is still shown. A paid plan keeps it updated.

The scan seems stuck

The scan runs as background tasks. If your site’s WordPress cron does not run (some hosts disable it), open the Clickfade screen and keep it open: it nudges the queue. For a permanent fix, set up a real server cron (see the next item).

Daily updates do not run

Pro updates run from WordPress background tasks. On low-traffic sites these may not fire on time. Add define( 'DISABLE_WP_CRON', true ); to wp-config.php and create a server cron job that calls wp-cron.php every five minutes, for example */5 * * * * wget -q -O - https://your-site.example/wp-cron.php?doing_wp_cron >/dev/null 2>&1. The report shows the newest final day and the last successful update, and warns when the data is more than five days behind.

The numbers look lower than in Search Console

Clickfade uses final data only and leaves out the last three days. It compares two periods of equal length, and Search Console itself does not return every page or query. Differences of a few percent are normal.

The plugin update does not appear

Updates are offered only to connected sites. Open Dashboard, Updates and click Check again. The plugin asks for updates at most every twelve hours.

I paid but Pro did not unlock

The plugin checks every few seconds while the checkout tab is open. If it did not unlock, open the Clickfade screen and click Check now, or reload it. Payments can take a minute to confirm. If it still shows the free plan after ten minutes, contact support with your site address.

AI analysis fails

The message says why: a rejected key (create a new one), no credit or a spending limit at your provider (add credit), rate limiting (wait a few minutes), a model your key cannot use (pick another), or a network problem (your host must allow outgoing HTTPS). Failed analyses are not counted when the provider never answered.

I moved or rebuilt my site

The archive is stored in your site’s database. If the site is wiped or moved without the Clickfade tables, the Pro archive has to be collected again from Search Console (up to 16 months). Export the report to CSV first if you want a copy.

Still stuck? Write to us from the address in the footer and include your site address and what you see on screen. Never send your API keys or passwords.