Table of Contents
- 1) What to Expect (functional summary)
- 2) Prerequisites & Precautions Before Installation
- 3) Installation & Initial Configuration (recommended)
- 4) Compatibility & Coexistence with AIOSEO / SEOPress
- 5) Risks to Avoid / Warnings (install & activation)
- 6) Ready-to-Use Checklist (copy/paste for your product page)
- 7) Additional Useful Notes
(Generative Engine Optimization / AI-First SEO)
1) What to Expect (functional summary) #
- License & Pro/Lite: key in the format
GEO-XXXX-XXXX-XXXX, remotely verified, valid 365 days, re-checked every 7 days. If verification fails, Pro features are disabled. - AI Sitemap: exposes
/ai-sitemap.xmlvia a rewrite rule + flush on activation; XML output differs for Lite/Pro (AI score, etc.); transient cache ~10 min, purged on content save. - robots.txt: adds an “AI Sitemap” block + specific allowances (GPTBot, ChatGPT-User, ClaudeBot, PerplexityBot).
- HTML tags for LLMs: injects
data-llmattributes into headings and paragraphs via thethe_contentfilter. - AI Summary (Premium option): injects an invisible summary at the top of content (
aria-hidden,display:none) when enabled. - AI bot detection (Pro): logs visits (last 1,000 records).
- JSON-LD: Organization (Lite) and enriched (Pro) markup auto-injected into
<head>. - SEO compatibility: anti-duplicate guard detects Yoast, Rank Math, SEOPress, AIOSEO and removes GEOmatic JSON-LD to avoid collisions; per-content opt-out via a metabox.
2) Prerequisites & Precautions Before Installation #
Environment
- Have WordPress admin access + a recent backup (files + DB).
- Allow outbound connections to geomatic.cloud for license verification (otherwise Pro won’t remain active).
- Existing SEO plugins (Yoast / Rank Math / AIOSEO / SEOPress):
- The plugin disables its own JSON-LD when one of these is detected (to prevent duplicates). This is good for compatibility—still verify final schema output after activation.
- If you want to use GEOmatic’s schema instead, uncheck/disable the other plugin’s JSON-LD output to avoid redundancy.
Caching/CDN
- AI sitemap is cached (10-minute transient) and purged on each save; adjust your page cache/CDN accordingly and force a purge after large imports if needed.
Engines/LLM Policies
- The plugin inserts
data-llmand invisible summaries (Premium). This is intended for AI agents but stay transparent: avoid deceptive hidden content and document it in your internal SEO policy.
Privacy (admin)
- The code displays an admin notice containing predefined license information; ensure no sensitive data is exposed to other admins.
3) Installation & Initial Configuration (recommended) #
Install & activate
- On activation, the plugin registers the
/ai-sitemap.xmlrewrite and flushes permalinks; no manual permalink setting is required.
Enter license (if Pro)
- Go to GEOmatic AI → License, enter a key like
GEO-XXXX-XXXX-XXXX. - The plugin tests the key on the server before saving it. Network failure = not saved, Pro inactive.
Basic settings (GEOmatic dashboard)
Enable based on your usage:
- JSON-LD Schema (if you’re not using another SEO plugin’s schema); injected into
<head>. - AI Sitemap (exposed at
/ai-sitemap.xml+ adds<link rel="sitemap" …>). - HTML Attributes (
data-llmon headings + paragraphs).
These options exist natively ingeomatic_ai_settings.
AI Summary (Premium)
- If on Pro, enable “Auto AI Summary” (menu: Open AI Key / Automatic AI Summary). The plugin injects an invisible summary at the top of content.
Quick checks
/ai-sitemap.xmlreturns XML (Pro: with priorities based on an AI score)./robots.txtcontainsSitemap: …/ai-sitemap.xml+ “AI Bot Access” blocks.- A test page shows
data-llmattributes in HTML (inspect element).
4) Compatibility & Coexistence with AIOSEO / SEOPress #
- JSON-LD schema: GEOmatic backs off if AIOSEO or SEOPress are active (detected via constants/classes) to avoid duplicate schema. You can re-enable GEOmatic per content via the “GEOmatic AI — Schema” metabox (toggle the “Disable …” in reverse).
- Sitemaps:
/ai-sitemap.xmlis additional (does not replace classic sitemaps from SEO plugins).robots.txtentry for “Sitemap:” is added by GEOmatic; keep one entry per sitemap type for cleanliness. - Tags & content:
data-llmattributes are added viathe_content(priority 9) — low conflict risk, but test with other filters (builders, shortcodes).
5) Risks to Avoid / Warnings (install & activation) #
- Invalid key or blocked network: wrong format or unreachable server ⇒ no Pro;
WP_DEBUGlogs will show it. - Double schema: do not enable multiple JSON-LD providers at once (Rich Results inconsistencies). GEOmatic already removes its hooks if AIOSEO/SEOPress are present—still verify a few key pages.
- Caches/CDN: purge cache if
/ai-sitemap.xmllooks stale beyond 10 minutes, or after large imports. - Hidden content (Premium summary): even if
aria-hidden, keep the summary consistent with the content to avoid any cloaking concerns. - Bot log: Pro detection stores up to 1,000 visits; on AI-heavy sites, monitor option size.
- Rewrites: activation flushes rules, but if
/ai-sitemap.xmlreturns 404, save permalinks to force another flush. - Admin notices: an admin notice shows license info; check relevance in multi-admin environments.
6) Ready-to-Use Checklist (copy/paste for your product page) #
- ✅ Full backup (files + DB)
- ✅ Install & activate GEOmatic AI
- ✅ Enter GEO-XXXX-XXXX-XXXX key (if Pro) and verify license status
- ✅ (With AIOSEO/SEOPress) Choose one JSON-LD provider (or let GEOmatic auto-disable its schema)
- ✅ Enable: AI Sitemap, HTML Attributes, (optional) GEOmatic JSON-LD if you’re not keeping AIOSEO/SEOPress schema
- ✅ (Pro) Enable Auto AI Summary if desired
- ✅ Verify /ai-sitemap.xml & /robots.txt
- ✅ Purge caches/CDN if needed
7) Additional Useful Notes #
<head>link to AI sitemap: a<link rel="sitemap" …>tag is added when AI Sitemap is enabled.ai.txt(infra option): code also supports rewriting/ai.txt(allow/deny AIs) when enabled in related options.- Admin menus/pages: Dashboard, License, AI Reporting, Bot Detection (Pro), and Open AI Key / Automatic AI Summary.
