Skip to main content

Rank Math Client Site Configuration SOP

Overview​

  • What: Bring a client WordPress site's Rank Math configuration to the Rank Math Configuration Standard. That covers modules, titles, builder post types, the sitemap, a working Google Search Console + GA4 connection, and clean email reports. Then prove that analytics data is actually arriving.
  • When: After Rank Math is installed on a new site, after any staging-to-live promotion, and whenever Rank Math shows a red Analytics status or a client reports empty GA4 or Search Console data.
  • Who: Operator: anyone with WordPress admin on the site and the access in Prerequisites (SC staff, a contractor, or an AI agent working through a browser). Approver: the SC account owner for the client, for any live change.
  • Time Required: 45 to 90 minutes, plus up to 24 hours for the first analytics fetch.

Scope. Use this SOP for the configuration and the Google connection on any site. A site still running SearchAtlas follows the migration SOP first; that SOP's Phase 3 step 9 hands off to step 4 below.

Why this exists. Rank Math's Analytics screen can look connected while it is reading the wrong property, or nothing at all. Tag delivery (GTM) working tells you nothing about whether Rank Math or GA4 is receiving data. Every failure below has happened on an SC site.

Prerequisites​

AccessLevelWhy
WordPress adminAdministratorRank Math settings
Google account used for the connectionOwner or Full user on the client's GSC Domain property, Editor on the GA4 propertyRank Math lists only what this account can see. SC creates Domain properties under setup@symphonycore.com (GSC setup SOP)
GTM containerPublishOnly if step 7 finds a consent problem
SSH / WP-CLI (access SOP)ReadTo confirm stored values. Optional but strongly recommended

Required information: the GA4 Measurement ID the site's GTM container fires (G-…), and the GSC property ID (sc-domain:<domain> for SC-created properties).

Upstream: GA4 property creation, GSC setup, and GTM on the site (GTM WordPress Plugin SOP).

Live-site rule. Every write to a live client site is presented as a change table and approved first, per the operator's approval gate. Back up first: the site's settings export (Status & Tools > Import & Export) at minimum.

Procedure​

1. Modules​

  1. [wp-admin] Rank Math > Dashboard > Modules: set every module to its state in the standard's module table. Any module the table does not mark On is Off.
  2. Check: reload the Modules screen and compare every toggle with the table. With WP-CLI, wp option get rank_math_modules --format=json gives the same answer.

2. Titles & Meta​

  1. Global Meta: separator |, robots default index, follow, and a default OG image (1200 × 630, JPG or PNG; not WebP, which some social networks do not render).
  2. Title template. Use %title% %page% %sep% <Brand>, with the brand typed literally, if the WordPress site name is longer than the brand. %sitename% expands to the full WordPress site name. A site named "Brand | Long Tagline" adds about 50 characters to every title and pushes the page's own words past Google's ~60-character cut-off. Do not shorten the site name instead, because schema and emails use it. Apply the same rule to Posts and Pages. A custom SEO title typed on a page or post replaces the template; who types the brand and who never does is set in the standard's Custom titles row.
    • Archives: set tag, date and author archives to noindex and turn them off in the sitemap, per the standard's Archives row.
  3. Builder and template post types: noindex and out of the sitemap. Theme-builder plugins register their templates as public posts. Examples: templately_library (Templately), elementor_library (Elementor), popups, and form or notification CPTs. Each one becomes an indexable URL such as /?templately_library=home. For every such post type, under Titles & Meta set Robots Meta: noindex (custom robots on), and under Sitemap Settings turn it off in both the XML and HTML sitemaps.
  4. Page schema default: open question for the workflow owner, recorded in the standard's Schema row. In Rank Math 1.0.279, the only global setting that drops the Article type is "None", and on the pilot site that removed the whole Organization and WebSite graph from every page, leaving only breadcrumbs. Until the owner rules, leave the global default as installed, and compare the JSON-LD (Rich Results Test) before and after any schema change.

3. Sitemap​

  1. Rank Math's Sitemap module owns /sitemap_index.xml; no other sitemap plugin is active (standard).
  2. Open /sitemap_index.xml. Every child sitemap should be a content type. A sitemap named after a builder or plugin post type means step 2.3 was missed.

4. Connect Google​

  1. [wp-admin] Rank Math > General Settings > Analytics > Connect (or Reconnect). On Google's screens, choose the account from Prerequisites and tick every permission checkbox. An unticked box makes one service fail silently. The person who owns the Google account signs in; an agent never enters the password.
  2. Search Console > Site: select the Domain property, which appears as sc-domain:<domain>.
    • Trap: the dropdown is a cache, not a live list. Rank Math stores the site list in rank_math_analytics_all_services and trims it to the saved choice on every save. A Reconnect does not refresh it. After a staging promotion it can hold only the old staging property displayed under the live URL. Selecting that and saving points Search Console at staging.
    • If sc-domain:<domain> is not offered, go to Troubleshooting T2. Do not click Disconnect to "refresh" (T3).
  3. Turn on Enable the Index Status tab with a real click on the toggle.
  4. Analytics: choose the account, the property, then the data stream. The stream list stays empty until a property is chosen. Avoid "Create new GA4 Property", which sits directly above existing properties in the list.
  5. "Install analytics code": OFF whenever GTM delivers GA4. A second tag double-counts.
  6. Save Changes. Every reload shows Property as "Select Property" even after a correct save. If you save again later, re-select the property and stream first, or the save writes them empty.

5. Email reports​

General Settings > Analytics > Email Reports: set the recipient, and check that the subject and logo URL use the live domain. After a staging promotion they keep the staging hostname, and a dead logo host shows as a broken image in every report. The logo can only be set through the media picker. To point it at the plugin's default image on the live domain, use wp option patch update rank-math-options-general console_email_logo <url>.

6. Settings export​

Export General, Titles & Meta, Sitemap and Role Manager to the client's client-reference/ folder (standard). Never export or import Redirections between sites.

7. Prove data is arriving​

A green Rank Math status only proves the API connection works. Check each of these:

  1. GA4 Admin > Data streams: the stream's Measurement ID equals the G- ID in GTM. The stream must not say "No data received in past 48 hours".
  2. Load a live page in a normal browser. Confirm the consent banner appears (for Cookiebot, Cookiebot.hasResponse in the console), and check the GA4 g/collect request in the Network tab for a gcs parameter. A CMP whose subscription lapsed shows no banner and leaves consent denied for every visitor (gcs=G100). GA4 then receives only cookieless pings, and the stream reads "Data collection isn't active". If so, go to T4.
  3. GA4 Reports > Realtime shows your own visit within a few minutes.

Verification​

CheckHowPass
ModulesBrowser: Rank Math > Dashboard > Modules. WP-CLI: wp option get rank_math_modules --format=jsonExactly the standard's list
TitlesView source on a page with no custom title, and on a post with onePage <title> ends in | <Brand>, no long tagline. Post renders its custom title as written
ArchivesView source on a tag archive; open /sitemap_index.xmlnoindex on the archive; no tag, author or date sitemap
Builder post types/sitemap_index.xml; view source on one builder URLNo builder sitemap; builder URL has noindex
GSC selectionBrowser: Rank Math > General Settings > Analytics shows sc-domain:<domain> after re-selecting (the screen shows "Select Property" on reload, step 4.6), and the Index Status tab loads data. WP-CLI: wp option get rank_math_google_analytic_profile --format=jsonprofile is sc-domain:<domain>; enable_index_status true
GA4 selectionBrowser: Rank Math > Analytics dashboard shows traffic for the property after the first fetch; GA4 Admin confirms the stream's Measurement ID. WP-CLI: wp option get rank_math_google_analytic_options --format=jsonRight property_id, measurement_id matches GTM, install_code false
Connection flagsBrowser: no red status on the Analytics settings screen after Test Connections. WP-CLI: wp option get rank_math_analytics_connection_error / rank_math_console_connection_errorEmpty or absent
Data flowingGA4 Realtime; stream status; GA4 hit has no gcs=G100Visit appears; stream not "No data received"
Email reportsSettings screenSubject and logo on the live domain; logo renders
AutomatedThe baseline audit in the Client Technical SEO Audit SOPNo FAIL findings

Troubleshooting​

#SymptomCauseFix
T1"GA4 not connected" but GTM is fineGTM only delivers the tag. Rank Math's connection is separate OAuth reporting accessDo step 4. Check the stored options, not the screen
T2GSC dropdown shows only the live URL, or a staging host, and never sc-domain:Stale cached site list (step 4.2 trap)Replace the cache with the Domain property, then select it in the UI and Save, so Rank Math's own permission check runs: wp eval '$a=get_option("rank_math_analytics_all_services",[]); $a["sites"]=["sc-domain:<domain>"=>"sc-domain:<domain>"]; update_option("rank_math_analytics_all_services",$a);'. This changes the cache only, never a setting
T3You are about to Disconnect and Connect to refresh the listOn first load with no cached accounts, Rank Math checks the literal site URL against Google's list. A Domain-only account fails that check, and Rank Math then auto-creates a URL-prefix property in the Google account (observed in Rank Math 1.0.279)Don't. Use Reconnect plus T2
T4GA4 stream "Data collection isn't active"; Realtime empty; hits carry gcs=G100Consent stuck at denied: CMP trial or plan lapsed, domain not authorised in the CMP, or banner disabled. The console shows the CMP's own errorRestore the CMP plan and authorise the domain, or (an account-owner decision, with compliance noted) pause the CMP tag in GTM and publish
T5Connection error flags stay 1 after a fixFlags clear on the next successful checkUse the screen's Test Connections link, then re-read the flags
T6A toggle shows on, but the saved value is falseThe settings screen is a React form, so a programmatic checkbox change is not savedClick the visible toggle itself
T7Saved Search Console profile is a staging hostT2's trap was savedT2, then re-save; confirm with the Verification command

Agent Quick Reference​

  • Read state before acting: rank_math_google_analytic_profile, rank_math_google_analytic_options, rank_math_analytics_all_services, both *_connection_error flags. Redact any token-like keys when printing.
  • STOP and hand to a human for: Google sign-in and consent, CMP account login, any GTM publish, any live save without an approved change table.
  • Never select "Create new GA4 Property". Never Disconnect to refresh the site list (T3).
  • After any live save, re-read the stored options. The screen is not evidence.

Revision History​

DateVersionChangeAuthor
2026-10-311.0Promoted to active: the active migration SOP and onboarding checklist WEB-08 already route operators here, and it was built from a full run on the SC site. Browser equivalents added for every WP-CLI verification check. Titles check corrected (posts deliberately carry no brand). Archives step and check added. Automated check points to the technical SEO audit SOPSymphony Core Systems Team
2026-10-060.2Rebased on the restructured standard (1.2) and migration SOP (0.11): modules read from the standard's module table; the page schema default is raised as an open question, because the standard's WebPage default conflicts with what the pilot observedSymphony Core Systems Team
2026-10-060.1Created from the first full run on the SC site: stale GSC site cache showing staging as live, Domain-property handling, the Disconnect auto-create trap, a lapsed CMP trial blocking all GA4 data, builder post types indexed, long %sitename% titles, and staging hostnames in email reportsSymphony Core Systems Team