Meta SEO Documentation

Everything you need to install, configure, and get value from Meta SEO. Written to be read from top to bottom, not searched in a panic.

Requirements

Meta SEO asks for little:

  • WordPress 6.0 or newer
  • PHP 7.4 or newer (PHP 8.x recommended)
  • No external services: the plugin makes zero outbound requests, so nothing needs to be whitelisted on your firewall
  • Works with the Block Editor and the Classic Editor
  • No persistent object cache or cron setup required
  • Multisite is not supported

Installation

Running another SEO plugin? Deactivate it first. Two plugins writing the same title tags and sitemap will conflict.

Option A - from your WordPress admin

  1. Download the plugin zip file.
  2. In your admin menu, go to Plugins, then Add New.
  3. Select Upload Plugin at the top of the screen.
  4. Choose the zip file and select Install Now.
  5. Select Activate. The setup wizard starts automatically; see the next section.

Option B - manual upload via SFTP or your hosting file manager

  1. Unzip the file on your computer. You get one plugin folder.
  2. Upload that folder into wp-content/plugins/ on your server.
  3. In your admin menu, go to Plugins.
  4. Find Meta SEO in the list and select Activate.
  5. A notice with a link to the setup wizard appears at the top of your admin; start it whenever you like.

First-Run Setup Wizard

The wizard asks six questions and takes about five minutes. Nothing is sent anywhere; every answer is stored in your own database.

  1. Welcome

    One short screen on what the plugin will and will not do.

  2. Site type

    Blog, business site, portfolio, or store. This sets default title patterns and content checks.

  3. Identity

    Your site name, tagline, and the separator character used in titles. Default: a hyphen.

  4. Title patterns

    Confirm or tweak the templates for the homepage, posts, and pages.

  5. Sitemap

    Choose which content types appear in the XML sitemap. Posts and pages are included by default.

  6. Structured data

    Whether the site represents an organization or a person, and whether breadcrumb schema is enabled.

A summary screen lists everything that was configured, with links to change any of it later. You are done; go write something.

Settings Reference

All settings live on one screen with six tabs, under Settings, then Meta SEO in your admin menu. Every option, in order:

General

Site type
Sets sensible defaults for title patterns and content checks. Options: blog, business, portfolio, store.
Organization or person
Who the site represents; used in structured data.
Organization name
Pre-filled from your site title; edit it if the public name differs.
Logo
A media library image used in organization markup.
Separator character
The character placed between the page title and the site name. Default: a hyphen.

Content Checks

Enable content checks
Master switch for the written review in the editor. Default: on.
Minimum word count
Posts shorter than this get a gentle nudge. Default: 300.
Suggested internal links
The checklist reminds you to link to at least this many of your own pages. Default: 2.
Reading ease check
Estimates how demanding your sentences are and suggests variety where it helps.
Checks column in posts list
Shows a completion count in the admin posts table. Default: off.

Titles and Meta

Homepage title
Custom title for your front page, or leave blank to use the site name.
Title patterns
Templates for posts, pages, and archives. Tokens: %title%, %site%, %sep%.
Description source
Use the excerpt, a manual field, or both; the manual field wins when filled.
Noindex controls
Per-post option to keep a single page out of search indexes. The sitewide default remains index.
Robots defaults
Sitewide defaults for index and follow. Leave them on unless you have a specific reason.

Social

Open Graph
Adds the tags used when links are shared. Default: on.
Twitter card type
Summary, or summary with a large image. Default: summary.
Default share image
Fallback image for pages without a featured image.
Per-post overrides
Title, description, and image for shares, set in the editor sidebar.

Sitemap

Enable XML sitemap
Master switch. Default: on.
Included content types
Posts, pages, and other public types.
Excluded entries
Comma-separated post IDs to leave out.
Sitemap path
Read-only display of your sitemap location with a copy button, so manual submission takes seconds. The plugin never contacts search engines itself.

Advanced

Keep settings on uninstall
Default: off. When off, deleting the plugin clears its settings and post meta.
Import from another SEO plugin
Reads titles and descriptions written in another SEO plugin so you can switch without retyping. Runs once, entirely locally.
Suppress front-end output
For developers: turns off meta tag output while keeping the checks active.

Content Checks Explained

Each check appears in the editor sidebar with a one-line explanation. Here is what the lines mean:

CheckWhat the line means
Title lengthAim for about 50 to 60 characters so titles are not cut off in results.
Description presentA one or two sentence summary; a missing one is the most common quick win.
First paragraph focusYour main topic should appear up front, the way a reader would expect.
Internal linksAt least two links to your own content help readers and crawlers alike.
Outbound linkOne link to a trustworthy source shows you did your homework.
Word countShort posts are fine; this only nudges below your set minimum.
Reading easeMany long sentences in a row earn a note suggesting variety.
Images with alt textFunctional images need text alternatives; decorative ones can be skipped.
SubheadingsPages over 600 words read better with a few section breaks.

Shortcodes and Template Tags

Two ways to print breadcrumbs in your theme, plus one filter for developers. Everything runs locally; no callback ever leaves the server.

any post, page, or widgetSHORTCODE
[meta_seo_breadcrumb]
theme filePHP
<?php if ( function_exists( 'meta_seo_breadcrumb' ) ) { meta_seo_breadcrumb(); } ?>

Check thresholds can be adjusted with the meta_seo_check_thresholds filter:

functions.phpPHP
add_filter( 'meta_seo_check_thresholds', 'my_custom_thresholds' );
function my_custom_thresholds( $thresholds ) {
    $thresholds['min_words'] = 500;
    $thresholds['internal_links'] = 3;
    return $thresholds;
}

Submitting Your Sitemap

Meta SEO never contacts search engines on its own. Submission is a two-minute manual task you fully control:

  1. Copy your sitemap path from Settings, then Meta SEO, then Sitemap.
  2. Sign in to Google Search Console, choose your property, and paste the path in the Sitemaps section.
  3. Repeat in Bing Webmaster Tools if you want coverage there as well.
  4. That is it. The sitemap updates automatically as you publish; you never submit it twice.

Google Search Console and Bing Webmaster Tools are independent services. Submission happens in your own accounts, and Meta SEO has no connection to either.

Uninstalling and Data Removal

  • Deactivating the plugin keeps its settings and post meta intact.
  • Deleting the plugin removes all settings and post meta, unless Keep settings on uninstall is on.
  • There is nothing to deregister elsewhere: the plugin never registered anything off your site.

FAQ

Does the plugin automatically notify search engines?
No. The plugin makes zero outbound requests; submission is manual and takes about two minutes. See Submitting Your Sitemap above.
My sitemap returns a 404. What now?
Go to Settings, then Permalinks, and select Save Changes once to refresh rewrite rules. If it persists, write to support@metaseo.net.
Can I use it on multiple sites?
Yes. The plugin is GPL-licensed; use it on as many sites as you like.
Does the importer delete anything from my old plugin?
No. It only reads titles and descriptions. Deactivate and remove the old plugin only when you are ready.
Does it work with the Classic Editor?
Yes. The content checks and meta fields appear in the Block Editor and in the Classic Editor.
How do I report a bug?
Email support@metaseo.net with BUG in the subject line, plus your WordPress and PHP versions. Every report gets a reply.

Getting Help

One mailbox, answered by the people who build the plugin: support@metaseo.net. Bug reports, setup questions, and feature wishes are all welcome.

Privacy questions: privacy@metaseo.net.

Back to top