# Install the WordPress plugin

> Install AnotherSEOGuru 4.4.1 on WordPress, connect the site with OAuth, and publish title and description changes back with approval and undo.

Source: https://anotherseoguru.com/en/help/integrations/wordpress-plugin

AnotherSEOGuru for WordPress is a full SEO plugin from Touristas Technologies. Version **4.4.1** handles titles, meta descriptions, schema, XML sitemaps, redirects, breadcrumbs, `llms.txt`, IndexNow and on-page checks in English and Greek. Connecting a free AnotherSEOGuru App account at [app.anotherseoguru.com](https://app.anotherseoguru.com) adds Search Console in the editor, keyword research and AI titles. There is no API key to paste.

![AnotherSEOGuru dashboard in WordPress admin, score 35 of 100, two alerts, task list and site features](https://anotherseoguru.com/images/help/wp-dashboard.webp)
*Dashboard on a local WordPress site with plugin 4.4.1. The account is not connected, so Search Console stays empty. No tokens are shown.*

## What the plugin does

On its own, with no account, the plugin owns SEO for the site. The admin menu is **AnotherSEOGuru**, with Dashboard, Settings, Integrations, Tools, Redirects, Local SEO, Workouts, Help and Approvals.

- **Editor.** Snippet preview, up to five focus keywords (100 characters each), readability in English and Greek, SEO and readability columns on the posts list, and quick edit for the title and description.
- **Titles and meta.** Templates per post type, taxonomy, homepage, archives, search and the 404 page. Variables include `%%title%%`, `%%sitename%%`, `%%sep%%`, `%%sitedesc%%`, `%%excerpt%%`, `%%category%%` and `%%page%%`. The `%title%` style works too.
- **Front end, when no other SEO plugin is active.** Schema graph, Open Graph and X cards, XML sitemaps, breadcrumbs, `llms.txt`, IndexNow and extra `robots.txt` lines.
- **With an account.** Search Console numbers in the editor, keyword research (5 credits) and three AI title or description options (1 credit). Google Analytics 4 is viewed in AnotherSEOGuru App, not inside the WordPress editor.

> **Note:** If Yoast SEO, Rank Math, All in One SEO, SEOPress or The SEO Framework is active, AnotherSEOGuru switches to companion mode. It prints nothing on the public site and writes titles into that plugin’s fields. Redirects and the 404 monitor start off.

## Requirements

| Requirement | Detail |
| --- | --- |
| WordPress | 6.2 or later. The plugin readme lists tested up to 6.9. |
| PHP | 7.4 or later. |
| Account link | The site must be served over **https**. WordPress only creates Application Passwords on https. |
| Who can connect | An administrator. Editors with `edit_others_posts` can open Approvals; only administrators change the approval switch. |
| Package | [anotherseoguru.zip](https://app.anotherseoguru.com/downloads/anotherseoguru.zip), version 4.4.1. |

## Install

1. **Download the zip** Get [anotherseoguru.zip](https://app.anotherseoguru.com/downloads/anotherseoguru.zip) from AnotherSEOGuru App. Do not rename the folder inside the zip.
2. **Upload it** In WordPress go to **Plugins → Add New Plugin → Upload Plugin**, choose the zip and click **Install Now**.
3. **Activate** Click **Activate**. The first activation opens the setup wizard (the Dashboard route `/setup`).
4. **Open the menu** Use **AnotherSEOGuru** in the left admin menu. A search box labelled **Search settings** jumps to any screen.

## Connect the site to AnotherSEOGuru App

Connection is OAuth 2.1 with PKCE, scope `read tasks:write wordpress`. The consent screen names the client **AnotherSEOGuru for WordPress** plus your host. Older builds that asked you to paste an API key are not how 4.4.1 works.

![AnotherSEOGuru account screen in WordPress, status Not connected, with a Sign up free button](https://anotherseoguru.com/images/help/wp-account.webp)
*Integrations → AnotherSEOGuru account before a connection. The button is Sign up free. This capture uses a local site and no real account.*

1. **Open the account screen** Go to **AnotherSEOGuru → Integrations → AnotherSEOGuru account**. A disconnected site shows **Not connected**.
2. **Start the connection** Click **Sign up free**. WordPress sends you to app.anotherseoguru.com. AnotherSEOGuru App’s consent screen offers **Allow** or **Cancel**. Use the account you already have, or create one there.
3. **Let the plugin finish the link** After you allow access, the plugin creates a WordPress Application Password named **AnotherSEOGuru** and sends the site URL, username, that password and the plugin version to `POST /api/v1/wordpress/link`. You never copy the password yourself.
4. **Confirm the status** The screen then shows **Connected**, **Open your dashboard** and **Disconnect**. Disconnect deletes that Application Password and tells AnotherSEOGuru App to stop applying changes here.

> **Warning:** If the site is not on https, or a security plugin has turned Application Passwords off, the OAuth login can succeed and the link still fails. WordPress shows why: no Application Passwords in this WordPress version, https required, or Application Passwords turned off.

## Every settings screen

Settings live in the React admin, not in an old tabbed PHP page. Names below are the labels in version 4.4.1. Defaults are what a new install stores.

### Site features

![Site features in the WordPress plugin with XML sitemaps, schema, redirects, llms.txt, IndexNow and breadcrumbs switched on](https://anotherseoguru.com/images/help/wp-features.webp)
*Settings → Site features on a fresh install. Each switch is on.*

| Switch | Default | What it does |
| --- | --- | --- |
| **XML sitemaps** | On | Publishes `/sitemap_index.xml` when the plugin is in standalone mode. |
| **Schema** | On | Prints the JSON-LD graph. |
| **Redirects** | On (off in companion mode) | Serves redirects from the plugin. |
| **llms.txt** | On | Publishes `/llms.txt`. |
| **Instant indexing** | On | IndexNow. A published or updated public URL can be submitted from the editor. |
| **Breadcrumbs** | On as a module; the trail itself starts off | Allows the breadcrumb functions. The trail is still off until you enable it under Breadcrumbs. |

### Site basics, representation and connections

![Site basics in the WordPress plugin with website name, title separator and homepage title template](https://anotherseoguru.com/images/help/wp-basics.webp)
*Settings → Site basics. The homepage template uses the variables sitename, page, sep and sitedesc.*

- **Website name** and **Alternate website name**.
- **Title separator**, used wherever a template contains `%%sep%%`.
- **This site represents** Organization or Person, plus the organization name or your name, and a square logo of at least 112 pixels.
- **Site connections.** Profiles for Facebook, X, Mastodon and other profiles. Webmaster verification codes for Google, Bing, Yandex, Pinterest, Baidu and Ahrefs.
- **Homepage** title template. A new site uses `%%sitename%% %%page%% %%sep%% %%sitedesc%%`.
- **Let search engines index this site** follows WordPress’s own “Search engine visibility” setting.
- **Restrict advanced settings for authors** hides advanced fields from authors.

### Content types, taxonomies and archives

Each public post type and taxonomy has its own screen. A new post type uses title `%%title%% %%page%% %%sep%% %%sitename%%` and description `%%excerpt%%`. Posts default to schema type BlogPosting and article type Article. Format archives start as noindex and out of the sitemap. Author, date and format archives, special pages, media pages and RSS each have a screen.

| Screen | What you set |
| --- | --- |
| **Media pages** | Enable media pages, show them in search results, show SEO controls, page type and article type. Media pages start disabled and noindex. |
| **RSS** | Text before and after each item. Variables include `%%AUTHORLINK%%`, `%%POSTLINK%%`, `%%BLOGLINK%%` and `%%BLOGDESCLINK%%`. |
| **Special pages** | Title templates for search results and the 404 page. |

### XML sitemaps

![XML sitemap settings with sitemaps and images on, news sitemap off, and 1000 entries per sitemap](https://anotherseoguru.com/images/help/wp-sitemaps.webp)
*Settings → XML sitemaps. Entries per sitemap defaults to 1000.*

| Setting | Default |
| --- | --- |
| **Generate XML sitemaps** | On |
| **Include images** | On |
| **News sitemap** | Off |
| **Entries per sitemap** | 1000 |
| **Exclude posts by ID** | Empty |

### Schema framework

**Output schema** turns the graph on (default on). The graph can include WebSite, Organization or Person, WebPage, BreadcrumbList and Article. Per-post types include Article, Product, Event, Recipe, Service, LocalBusiness and TouristTrip. A schema template can add one type to every item of a post type. FAQ and How-to blocks in the editor become FAQPage and HowTo structured data.

![Schema framework settings in the WordPress plugin](https://anotherseoguru.com/images/help/wp-schema.webp)
*Settings → Schema framework.*

### Crawl optimization and llms.txt

**Crawl optimization** can strip feeds, shortlinks, the generator tag, emoji scripts and other WordPress head noise. Search cleanup includes **Maximum characters in a search** (default 50) and **Allowed parameters**. **Extra lines** are appended to `robots.txt`.

AI crawlers you can block, one switch each: GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-SearchBot, PerplexityBot, Google-Extended, Applebot-Extended, CCBot, Bytespider, meta-externalagent, Amazonbot and AdsBot-Google.

![llms.txt settings in the WordPress plugin](https://anotherseoguru.com/images/help/wp-llms.webp)
*Settings → llms.txt. Publish llms.txt is on. Items per type defaults to 50.*

| llms.txt setting | Default |
| --- | --- |
| **Publish llms.txt** | On. The file is `/llms.txt`, and only while the plugin is in standalone mode. |
| **Items per type** | 50 |
| **File contents** | Auto (site name, description and main pages) or your own Markdown. |

### Breadcrumbs

The trail starts **off** even when the Site features module is on. Turn on **Enable breadcrumbs**. Other fields: separator (default `»`), anchor text for the homepage, prefix for the trail, prefix for archives, prefix for search pages, 404 page label, bold the last page, show on the homepage, show the blog page, and theme support. You can also use the shortcode `[asg_breadcrumbs]` or `do_action('asg_breadcrumbs')`.

### Redirects

![Empty redirects table in the WordPress plugin with type, code and target fields](https://anotherseoguru.com/images/help/wp-redirects.webp)
*AnotherSEOGuru → Redirects on a new site. Loop detection is on.*

- Codes: **301, 302, 307, 410, 451**. Match type: plain or regex (regex pattern up to 255 characters).
- Defaults: redirects enabled, 404 monitor on, log kept **30 days**, automatic slug redirect on, method PHP. In companion mode, redirects and the 404 monitor start off.
- The **404 log** lists hits. **Redirect settings** holds the switches above.

### Local SEO, integrations and tools

**Local SEO** (off until you enable the module) has Business details, Opening hours, Locations, Maps and Display. Business fields include address, phone, VAT, tax ID, currencies, payment methods and opening hours.

![WordPress integrations screen with several services marked Not available yet](https://anotherseoguru.com/images/help/wp-integrations.webp)
*Integrations. Several third-party switches are labelled Not available yet in 4.4.1. Do not treat those as working connections.*

- **Tools → Import and export.** Bring in Yoast, Rank Math, All in One SEO, SEOPress, and redirects from the Redirection plugin. Run a dry run first. Old data in the other plugin is not deleted.
- **Tools → File editor** and **Bulk editor**.
- **Tools → SEO data optimization** stores the scores used by the posts list.
- **Workouts** include a cornerstone workout and an orphaned-content workout.
- Ahrefs on this screen is a verification code you can save. Semrush, SEOTesting, rank tracking inside WordPress, Elementor, WooCommerce, TranslatePress, custom fields, Jetpack and Site Kit are marked **Not available yet**.

![Import and export screen with Yoast, Rank Math, AIOSEO, SEOPress and Redirection listed as not detected](https://anotherseoguru.com/images/help/wp-import.webp)
*Tools → Import and export on a site that has none of those plugins. The settings backup download and restore are on the same screen.*

## Two-way sync with AnotherSEOGuru App

Once the site is linked, AnotherSEOGuru App reads published content from WordPress and writes titles and descriptions back through the same plugin. The plugin is the place that applies, holds or undoes a change. This guide does not name buttons inside AnotherSEOGuru App, because those labels are not in the plugin package.

1. **AnotherSEOGuru App reads published items** WordPress exposes `GET /wp-json/asg/v1/seo-index`. The default post type is page. Only **published** items are included, newest modified first, up to **100** per page. Each item returns the post id, URL, post type, and the raw SEO title and description. Callers who cannot edit that post are skipped.
2. **A write goes through the change log** `POST /wp-json/asg/v1/seo` and `POST /wp-json/asg/v1/seo-bulk` set the title, the description, or both. Every write stores the previous value. If **Require approval** is on, the write stays pending instead of going live.
3. **A conditional write checks the page has not moved** `POST /wp-json/asg/v1/seo-change` is stricter. The post must be published, the field must be title or description, and the expected snapshot version must still match. If someone edited the page after the preview, WordPress refuses the write so an old suggestion cannot overwrite a newer one.
4. **Applied changes are sent back** Applied rows are posted to AnotherSEOGuru App at `POST /api/v1/wordpress/changes`, up to 20 per request, with the site URL. The log itself stays in WordPress (option `asg_change_log`, newest 200 rows).

> **Tip:** Task sync runs at most every 300 seconds. Opening a plugin screen or the post editor also syncs when the account is connected. Search Console numbers shown in the editor are cached for one minute.

## Approvals, history and undo

![WordPress Approvals screen with require-approval unchecked, SEO tools on, and empty waiting and change-log tables](https://anotherseoguru.com/images/help/wp-approvals.webp)
*AnotherSEOGuru → Approvals on a local site. The domain line shows the authorized host and this site. Nothing is waiting, so both tables say Nothing here yet.*

Open **AnotherSEOGuru → Approvals**. Editors can review. Administrators also see the switches.

| Control | What it does |
| --- | --- |
| **Authorized domain** | Writes are refused when the current host is not the authorized one (a copied or staging site). An administrator uses **Re-authorize this domain** to allow this host. |
| **Require approval before the app, MCP or chat can change SEO** | Off by default. On, those writes wait in **Waiting for approval**. |
| **SEO tools** | Each tool can be On or off: List content, Read SEO, Update SEO, Read schema, Update schema, List redirects, Create redirect, Update redirect, Delete redirect, Suggest internal links, Insert internal link. |

Both tables use the columns **When, Who, Change, Before, After, Status**. Who is the actor (`app`, `mcp`, `user` or `chat`) plus the login when there is one. Buttons:

- **Approve** or **Reject** on a pending row.
- **Undo** on an applied row that has not already been undone. Undo writes the previous value back.
- **Publish draft** when a row is a draft preview.

**SEO chat** on the same screen asks AnotherSEOGuru App for a title or description. The prompt says: “Ask the AnotherSEOGuru app for a title or description. Suggestions wait in the list above until you approve them.” Page ID is optional. The message can be up to 2000 characters. Suggestions are stored as approvals. They are not published by the chat form itself.

> **Note:** The plugin does not edit a page-builder layout. Title, description, schema and the other SEO tools above are the writes it will apply.

## On a page or post

The block editor and the classic editor both get an AnotherSEOGuru panel.

- **Focus keywords.** Up to five, each up to 100 characters, stored as `_asg_focus_keywords`. Checks cover the title, description, URL, introduction, subheadings, image alt text, density, length and links.
- **Snippet length.** The preview measures pixels. Desktop titles are flagged around 580 pixels (a short title under about 300). Mobile titles use about 540. Descriptions use about 920 desktop and 680 mobile.
- **Keyword research** calls AnotherSEOGuru App and costs **5 credits**. **AI meta** returns three options and costs **1 credit**. If the account is out of credits the editor says to add credits in AnotherSEOGuru.
- **Connected changes** in the editor is the same task and approval history. Refresh to see the latest status.
- The posts list can show SEO and readability scores, and quick edit can set the title, description and noindex.

## Troubleshooting

| What you see | What to do |
| --- | --- |
| Account stays **Not connected** | Finish **Sign up free** and choose Allow on AnotherSEOGuru App. If you closed the window, start again from Integrations → AnotherSEOGuru account. |
| Connected, but the link failed | The site must be https, and Application Passwords must be available for your user. A security plugin can turn them off. |
| Writes do nothing on a staging copy | Approvals shows a domain mismatch. Use **Re-authorize this domain** only on the copy you mean to edit. |
| A title from AnotherSEOGuru App never appears | Open **Waiting for approval**. If approval is required, click **Approve**. If the page changed after the preview, the conditional write is refused and AnotherSEOGuru App has to send a fresh one. |
| **Undo** is missing | Undo is only on a row whose status is applied and that has not already been undone. |
| No sitemap or schema on the public site | Another SEO plugin is active, so this one is in companion mode and prints nothing on the front end. Or the matching switch under Site features is off. |
| Import found nothing | Yoast, Rank Math, All in One SEO, SEOPress or Redirection has to be installed. The import screen says **Not detected** when it is not. |

## FAQ

**Do I paste an API key into the plugin?**

No. Version 4.4.1 connects with OAuth. The plugin creates an Application Password named AnotherSEOGuru and sends it to AnotherSEOGuru App. You do not copy a key.

**Does the plugin work without an account?**

Yes. Titles, schema, sitemaps, redirects, breadcrumbs, llms.txt and the on-page checks work with no account. Search Console, keyword research and AI titles need the connection.

**Will it replace Yoast or Rank Math?**

Only if you want it to. While another SEO plugin is active, AnotherSEOGuru stays in companion mode, writes into that plugin’s fields, and does not print its own tags. Import copies data across and leaves the old data in place.

**Where do I approve a change before it goes live?**

AnotherSEOGuru → Approvals. Turn on Require approval before the app, MCP or chat can change SEO. Pending rows have Approve and Reject. Applied rows have Undo.

**How far back does the change log go?**

The plugin keeps the newest 200 rows in WordPress. Undo is available on an applied row until you undo it or the row ages out of that list.

**Which content is imported into AnotherSEOGuru App?**

The index endpoint returns published posts and pages (and any other public post type you request), with the current SEO title and description. Drafts are not in that index.