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
| Access | Level | Why |
|---|---|---|
| WordPress admin | Administrator | Rank Math settings |
| Google account used for the connection | Owner or Full user on the client's GSC Domain property, Editor on the GA4 property | Rank Math lists only what this account can see. SC creates Domain properties under setup@symphonycore.com (GSC setup SOP) |
| GTM container | Publish | Only if step 7 finds a consent problem |
| SSH / WP-CLI (access SOP) | Read | To 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
[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.- Check: reload the Modules screen and compare every toggle with the table. With WP-CLI,
wp option get rank_math_modules --format=jsongives the same answer.
2. Titles & Meta
- Global Meta: separator
|, robots defaultindex, follow, and a default OG image (1200 × 630, JPG or PNG; not WebP, which some social networks do not render). - 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.
- 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. - 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
Articletype 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
- Rank Math's Sitemap module owns
/sitemap_index.xml; no other sitemap plugin is active (standard). - 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
[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.- 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_servicesand 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).
- Trap: the dropdown is a cache, not a live list. Rank Math stores the site list in
- Turn on Enable the Index Status tab with a real click on the toggle.
- 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.
- "Install analytics code": OFF whenever GTM delivers GA4. A second tag double-counts.
- 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:
- 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". - Load a live page in a normal browser. Confirm the consent banner appears (for Cookiebot,
Cookiebot.hasResponsein the console), and check the GA4g/collectrequest in the Network tab for agcsparameter. 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. - GA4 Reports > Realtime shows your own visit within a few minutes.
Verification
| Check | How | Pass |
|---|---|---|
| Modules | Browser: Rank Math > Dashboard > Modules. WP-CLI: wp option get rank_math_modules --format=json | Exactly the standard's list |
| Titles | View source on a page with no custom title, and on a post with one | Page <title> ends in | <Brand>, no long tagline. Post renders its custom title as written |
| Archives | View source on a tag archive; open /sitemap_index.xml | noindex on the archive; no tag, author or date sitemap |
| Builder post types | /sitemap_index.xml; view source on one builder URL | No builder sitemap; builder URL has noindex |
| GSC selection | Browser: 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=json | profile is sc-domain:<domain>; enable_index_status true |
| GA4 selection | Browser: 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=json | Right property_id, measurement_id matches GTM, install_code false |
| Connection flags | Browser: 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_error | Empty or absent |
| Data flowing | GA4 Realtime; stream status; GA4 hit has no gcs=G100 | Visit appears; stream not "No data received" |
| Email reports | Settings screen | Subject and logo on the live domain; logo renders |
| Automated | The baseline audit in the Client Technical SEO Audit SOP | No FAIL findings |
Troubleshooting
| # | Symptom | Cause | Fix |
|---|---|---|---|
| T1 | "GA4 not connected" but GTM is fine | GTM only delivers the tag. Rank Math's connection is separate OAuth reporting access | Do step 4. Check the stored options, not the screen |
| T2 | GSC 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 |
| T3 | You are about to Disconnect and Connect to refresh the list | On 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 |
| T4 | GA4 stream "Data collection isn't active"; Realtime empty; hits carry gcs=G100 | Consent stuck at denied: CMP trial or plan lapsed, domain not authorised in the CMP, or banner disabled. The console shows the CMP's own error | Restore the CMP plan and authorise the domain, or (an account-owner decision, with compliance noted) pause the CMP tag in GTM and publish |
| T5 | Connection error flags stay 1 after a fix | Flags clear on the next successful check | Use the screen's Test Connections link, then re-read the flags |
| T6 | A toggle shows on, but the saved value is false | The settings screen is a React form, so a programmatic checkbox change is not saved | Click the visible toggle itself |
| T7 | Saved Search Console profile is a staging host | T2's trap was saved | T2, 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_errorflags. 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.
Related Documents
- Rank Math Configuration Standard: the baseline values this SOP applies
- WordPress SEO Plugin Migration: SearchAtlas to Rank Math SOP: install and migration; its Phase 3 step 9 hands off here
- Google Search Console Property Setup SOP
- GA4 Property Creation SOP
- GTM WordPress Plugin SOP · GTM Validation SOP
- Client Technical SEO Audit SOP: the recurring check that the site stays on this configuration
Revision History
| Date | Version | Change | Author |
|---|---|---|---|
| 2026-10-31 | 1.0 | Promoted 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 SOP | Symphony Core Systems Team |
| 2026-10-06 | 0.2 | Rebased 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 observed | Symphony Core Systems Team |
| 2026-10-06 | 0.1 | Created 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 reports | Symphony Core Systems Team |