Chapter 01
Getting Started
Aetos SEO is a WordPress plugin that audits your website's technical SEO and AI-readiness, then exports a structured bundle you can feed into ChatGPT, Claude, or any AI assistant so the AI gives you fixes based on your actual site — not generic advice.
This page is the complete user guide. If you just bought a license and want the fastest path to your first report, follow Chapters 02 → 03 → 04 (about 10 minutes total).
- A WordPress site (version 6.2 or newer)
- PHP 7.4+ on your hosting (PHP 8.2+ recommended)
- Administrator access to WP Admin
- Your license key (sent to you by email — format
AET-XXXXXXXXXXXXXXXX) - Your personalized download link (also in the email)
Chapter 02
Installation
Each Aetos SEO build is cryptographically bound to one domain. Your download link in the welcome email contains a build prepared specifically for your site. Do not share or reuse on another domain — it will refuse to activate.
Step-by-step
- Open the download link from your welcome email. The ZIP file (~650 KB) downloads to your computer.
- In WordPress, go to Plugins → Add New → Upload Plugin.
- Click Choose File, select the ZIP you just downloaded.
- Click Install Now, wait ~3 seconds.
- Click Activate Plugin.
- You'll see a new Aetos SEO menu item in the WordPress sidebar.
Chapter 03
License & Activation
Aetos SEO uses a domain-bound licensing model. Each license is tied to a single domain you specified at purchase. Here's what you can expect:
Where to view your license status
In WP Admin, go to Aetos SEO → License. You'll see:
- Your tier (Lite, Pro, or Agency)
- The domain bound to the license
- The expiry date
- Status (Active / Expired / Domain mismatch)
What each tier includes
| Capability | Lite | Pro | Agency |
|---|---|---|---|
| Audit scope | Real engine, user-set depth | User-set depth + Pro modules | User-set depth + Pro modules |
| AI Readiness scoring | — | Yes | Yes |
| AI Export bundle (JSON) | — | Yes | Yes |
| Schema audit + validation (Product, Article, FAQ, HowTo) | — | Yes | Yes |
| Sitemap audit + validation | — | Yes | Yes |
| Sites included | 1 | 1 | 5 |
| Updates & support | 1 year | 1 year | 1 year |
Domain transfer
If you move your site to a new domain (e.g., during a rebrand or migration), reply to your welcome email and we'll re-issue the build for the new domain. Pro and Agency licenses include 1 free transfer per year.
Renewal
About 14 days before expiry, you'll receive a renewal reminder. After expiry, the plugin continues to function for a 14-day grace period, then audits are disabled until renewal. You won't lose any data — your reports stay accessible.
Chapter 04
Running Your First Audit
A full audit scans your site against dozens of technical and AI-readiness checks. Most sites complete in 2-3 minutes.
How to run it
- Open Aetos SEO → Audit.
- Click Run Full Site Audit.
- A progress bar appears. Don't close the browser tab — the scan runs in the background but the UI keeps it visible.
- When complete, click View Results.
What gets checked
The full audit covers, among others:
- Technical foundation: robots.txt, sitemap, canonical tags, meta robots, hreflang, redirects
- Page-level signals: titles, descriptions, headings, internal linking, image alt text
- Schema markup: Organization, Product, Article, FAQ, BreadcrumbList — what exists and what's malformed
- Performance signals: Core Web Vitals (LCP, CLS, INP) via PageSpeed Insights API if connected
- AI readiness: structured data coverage, content depth, entity clarity, citation-worthiness
- Indexability: noindex flags, blocked resources, orphan pages
Partial audits
For large sites, you can run targeted audits — pick a single category (e.g., "Schema only") to scan in 30 seconds. Use this when you've just fixed something and want to verify the change.
Chapter 05
Reading the Report
The Results page is organized into three views:
1. Priority Actions
A short list of the highest-impact fixes for your site. Each item shows:
- Severity — critical, high, medium, low
- Affected pages — how many URLs have the issue
- What to do — a one-paragraph fix description
- Estimated impact — qualitative ("major" / "moderate" / "minor")
2. Findings (full)
Every check that ran, grouped by category. Use this when you want the complete picture, including checks that passed.
3. By URL
Pivots the same data by page. Useful when you're debugging a single URL — you see every issue that page has, on one screen.
Severity definitions
| Level | Meaning | Typical examples |
|---|---|---|
| Critical | Will harm rankings or indexing now | noindex on important pages, broken canonicals, missing sitemap |
| High | Major missed opportunity | No structured data, missing meta descriptions on top pages |
| Medium | Should fix but not urgent | Long titles, thin content, missing alt text |
| Low | Nice-to-have polish | Sub-optimal heading order, redirect chains under 2 hops |
Chapter 06
AI Context Export
This is the feature that makes Aetos SEO different from a regular auditor. After every full audit, you can export a single JSON context file that contains:
- Your site's structural audit (every check, every URL, every finding)
- A snapshot of your WordPress runtime environment
- Log signals (recent errors, slow queries, if available)
- A normalized priority list ready for an AI to act on
How to export
- From the Results page, click Export.
- You get a JSON file (usually 1-4 MB).
How to use it with AI
- Open ChatGPT (or Claude, or any chat AI that accepts attachments).
- Attach the JSON file.
- Ask the AI a question like: "Fix the top 5 issues on the priority list. For each issue, give me the exact code or WordPress setting change."
- The AI now has ground-truth context for your site — its suggestions are specific, not generic.
Chapter 07
In-WordPress Messages
From time to time, we may send a message that appears inside your WordPress admin — for example, a release announcement, an urgent security note, or a tip relevant to your tier.
What you'll see
Messages appear as a standard WordPress admin notice at the top of any Aetos SEO page. They include a title, a short body, and sometimes a button (e.g., "Read more"). Each message is dismissible — click the X in the corner.
What we will send
- New version announcements (so you know when to update)
- Security advisories (rare, only when relevant to you)
- Tips on a feature you haven't used yet
What we will NOT send
- Marketing for unrelated products
- Notifications outside Aetos SEO pages (we never touch your regular WP admin)
- Anything you didn't opt into
Chapter 08
Receiving Updates
Aetos SEO updates the same way every other WordPress plugin does. When we release a new version, WordPress shows an "update available" notice under Aetos SEO on the Plugins screen. You update with one click — your license and audit history stay intact. The details of every release live on our changelog.
How to update (one click)
- In WordPress: Plugins → Installed Plugins.
- Find Aetos SEO. When an update is available you'll see "There is a new version… Update now."
- Click Update now. WordPress fetches the new build bound to your license and swaps it in place — no re-entering the license, nothing lost.
Chapter 09
Troubleshooting
The license says "Domain mismatch"
This means the ZIP you uploaded was built for a different domain than the one you installed on. The most common cause: the same ZIP installed on two different sites. Reply to your welcome email with the new domain — we'll re-issue the build (Pro/Agency: 1 free transfer per year).
The license says "Invalid" or "Tampered"
The ZIP file may have been edited after we built it, or downloaded incompletely. Re-download from the link in your welcome email and re-install. If it persists, contact support.
The audit gets stuck on "Running…"
Audits self-recover after 15 minutes. You can force-recover sooner by going to Aetos SEO → System Health → Recover Scan State. The most common cause is a temporary PHP timeout or a memory limit on shared hosting.
Activation fails on shared hosting (Hostinger, SiteGround, etc.)
Almost always a PHP version issue. We require PHP 7.4 or newer. In your hosting control panel, find the PHP version selector and upgrade to PHP 8.2 (the current recommended version). The plugin will then activate cleanly.
I deleted the plugin and now my menu is gone, but the folder is still there
Some hosts hold a file lock on the plugin folder after a failed deactivation. Use your hosting file manager (cPanel, hPanel, etc.) to delete the folder wp-content/plugins/nsr-elmtagr-seo/ manually. Then re-install from the ZIP.
I get a "403 Forbidden" on every Aetos SEO page
This usually means another plugin or a security firewall (like Wordfence) is blocking AJAX calls. Try temporarily disabling the firewall, or add an exception for admin-ajax.php requests from your own IP.
The PageSpeed Insights checks return zero data
You need a Google PageSpeed API key (free quota up to 25,000 requests/day). Get one at Google's PageSpeed Insights page, then paste it into Aetos SEO → Settings → Performance.
Chapter 10
Getting Support
Pro and Agency licenses include 1 year of email support. The fastest way to reach us:
- Email: support@aetosseo.com — we reply within 1 business day, usually same day.
- WhatsApp: +20 106 818 7346 — Sunday-Thursday 10:00-18:00 Cairo time.
- Reply to your welcome email — keeps the conversation threaded.
What to include when reporting an issue
- The exact error message you see (a screenshot helps)
- Your WordPress version, PHP version, hosting provider
- What you were doing when the issue happened
- Optional: the AI Export Bundle (gives us full context in one file)