docs

Validation Messages

Every SEO field in the plugin runs a set of real-time checks as you type. Feedback messages appear directly inside the Studio next to each field, colour-coded by severity so editors know exactly what to fix and why. Image fields cross-check each other to encourage full Meta, OG, and Twitter image coverage.

Severity Legend

Error

Critical issue that will actively harm SEO or prevent a field from being useful. Must be resolved.

Warning

Advisory warning. The field works but falls outside best-practice guidelines. Recommended to fix.

Pass

The check passed. No action needed for this rule.

Keyword mode: Some checks only run when the field is part of a parent seoFields object that has keywords configured. Standalone openGraph or twitter schema objects skip keyword checks. These rules are marked (keyword mode) in the tables below.

Stop Words

Titles and descriptions that start with a filler word are flagged with an orange warning. The current stop-word list is:

theaanandorbut

Meta Title

min 50 · max 60 characters

Shown as the clickable headline in search engine results (SERP). Directly influences click-through rate and keyword relevance.

Severity	Condition	Message shown in Studio
Error	Field is empty	Meta Title is empty. Add content to improve SEO.
Warning	Length < 50 characters	Title is n characters — below recommended 50.
Error	Length > 60 characters	Title is n characters — exceeds recommended 60.
Pass	Length 50–60 characters	Title length (n) looks good for SEO.
Pass	Keyword found in title (keyword mode)	Keyword found in title — good job!
Error	Keywords set but none appear in title (keyword mode)	Keywords defined but missing in title.
Warning	Any keyword appears more than 3 times (keyword mode)	Keyword appears too many times — avoid keyword stuffing.
Warning	No keywords have been defined (keyword mode)	No keywords defined. Consider adding relevant keywords.
Warning	First word is a stop word (the, a, an, and, or, but)	Title starts with a stop word — consider rephrasing.
Warning	Two or more consecutive special characters (!@#$%^&*)	Title contains excessive punctuation — simplify it.

Meta Description

min 120 · max 160 characters

The short summary shown below the title in search results. Does not directly affect ranking but strongly influences click-through rate.

Severity	Condition	Message shown in Studio
Error	Field is empty	Meta description is empty. Add content to improve SEO.
Warning	Length < 120 characters	Description is n chars — below recommended 120.
Error	Length > 160 characters	Description is n chars — exceeds recommended 160.
Pass	Length 120–160 characters	Description length (n) looks good for SEO.
Pass	Keyword found in description (keyword mode)	Keyword found in description — good job!
Error	Keywords set but none appear in description (keyword mode)	Keywords defined but missing in description.
Warning	Any keyword appears more than 3 times (keyword mode)	Keyword appears too many times — avoid keyword stuffing.
Warning	No keywords have been defined (keyword mode)	No keywords defined. Consider adding relevant keywords.
Warning	First word is a stop word (the, a, an, and, or, but)	Description starts with a stop word — consider rephrasing.
Warning	Two or more consecutive special characters (!@#$%^&*)	Description contains excessive punctuation — simplify it.

Open Graph Title

min 40 · max 60 characters

The title shown when your page is shared on Facebook, LinkedIn, and other OG-aware platforms. Separate from the meta title.

Severity	Condition	Message shown in Studio
Error	Field is empty	OG Title is empty. Add content for better social preview.
Warning	Length < 40 characters	OG Title is n chars — shorter than recommended 40.
Error	Length > 60 characters	OG Title is n chars — exceeds recommended 60.
Pass	Length 40–60 characters	OG Title length (n) looks good.
Pass	Keyword found in OG title (keyword mode)	Keyword found in OG title — good job!
Error	Keywords set but none appear in OG title (keyword mode)	Keywords defined but missing in OG title.
Warning	Any keyword appears more than 3 times (keyword mode)	Keyword appears too many times in OG title — avoid keyword stuffing.
Warning	No keywords have been defined (keyword mode)	No keywords defined. Consider adding relevant keywords.
Warning	First word is a stop word (the, a, an, and, or, but)	OG Title starts with a stop word — consider rephrasing.
Warning	Two or more consecutive special characters (!@#$%^&*)	OG Title contains excessive punctuation — simplify it.

Open Graph Description

min 90 · max 120 characters

The description shown under the OG title when links are shared on social platforms. Should entice readers to click through.

Severity	Condition	Message shown in Studio
Error	Field is empty	OG Description is empty. Add content for better social preview.
Warning	Length < 90 characters	OG Description is n chars — shorter than recommended 90.
Error	Length > 120 characters	OG Description is n chars — exceeds recommended 120.
Pass	Length 90–120 characters	OG Description length (n) looks good.
Pass	Keyword found in OG description (keyword mode)	Keyword found in OG description — good job!
Error	Keywords set but none appear in OG description (keyword mode)	Keywords defined but missing in OG description.
Warning	Any keyword appears more than 3 times (keyword mode)	Keyword appears too many times in OG description — avoid keyword stuffing.
Warning	No keywords have been defined (keyword mode)	No keywords defined. Consider adding relevant keywords.
Warning	First word is a stop word (the, a, an, and, or, but)	OG Description starts with a stop word — consider rephrasing.
Warning	Two or more consecutive special characters (!@#$%^&*)	OG Description contains excessive punctuation — simplify it.

X (Twitter) Title

min 30 · max 70 characters

The title shown when your page is shared on X (formerly Twitter). Overrides the OG title specifically for X cards.

Severity	Condition	Message shown in Studio
Error	Field is empty	X Title is empty. Add content for better SEO.
Warning	Length < 30 characters	X Title is n chars — shorter than recommended 30.
Error	Length > 70 characters	X Title is n chars — exceeds recommended 70.
Pass	Length 30–70 characters	X Title length (n) looks good.
Pass	Keyword found in X title (keyword mode)	Keyword found in X title — good job!
Error	Keywords set but none appear in X title (keyword mode)	Keywords defined but missing in X title.
Warning	No keywords have been defined (keyword mode)	No keywords defined. Consider adding relevant keywords.
Warning	Two or more consecutive special characters (!@#$%^&*)	X Title has excessive punctuation — simplify it.

X (Twitter) Description

min 50 · max 200 characters

The description shown under the X title in a Twitter/X card. Overrides the OG description for X previews.

Severity	Condition	Message shown in Studio
Error	Field is empty	X Description is empty. Add content for better SEO.
Warning	Length < 50 characters	X Description is n chars — shorter than recommended 50.
Error	Length > 200 characters	X Description is n chars — exceeds recommended 200.
Pass	Length 50–200 characters	X Description length (n) looks good.
Pass	Keyword found in X description (keyword mode)	Keyword found in X description — good job!
Error	Keywords set but none appear in X description (keyword mode)	Keywords defined but missing in X description.
Warning	No keywords have been defined (keyword mode)	No keywords defined. Consider adding relevant keywords.
Warning	Two or more consecutive special characters (!@#$%^&*)	X Description has excessive punctuation — simplify it.

Meta Image

The default image used in search engine results and as a fallback for social sharing. Recommended size is 1200×630px. Also cross-checks whether OG and Twitter images are configured.

Severity	Condition	Message shown in Studio
Error	No image asset uploaded	No meta image provided. Adding an image improves click-through rates.
Pass	Image asset is present	Meta image is set — great for SEO and social sharing.
Warning	Image set but both OG and Twitter images are missing	OG and Twitter images are missing — add them for full social coverage.
Warning	Image set but OG image is missing	OG image is missing — add it for better Facebook/LinkedIn previews.
Warning	Image set but Twitter image is missing	Twitter image is missing — add it for better X (Twitter) cards.
Pass	Meta, OG, and Twitter images are all configured	All images set (Meta, OG, Twitter) — full coverage!

OG Image (Upload)

The image used when your page is shared on Facebook, LinkedIn, and other OG-aware platforms. Shown when imageType is set to 'Upload Image'. Also checks alt text and cross-checks Meta/Twitter images.

Severity	Condition	Message shown in Studio
Error	No image asset uploaded	No OG image provided. Social shares will lack a visual preview.
Pass	Image asset is present	OG image is set — good for social sharing.
Pass	Alt text field is filled	Alt text is set — good for accessibility.
Warning	Alt text field is empty	Consider adding alt text for better accessibility.
Pass	Meta, OG, and Twitter images are all configured	All images set (Meta, OG, Twitter) — full coverage!
Warning	Meta image is missing	Meta image is missing — add it for search engine results.
Warning	Twitter image is missing	Twitter image is missing — add it for X (Twitter) cards.

OG Image URL

An external URL for the OG image. Shown when imageType is set to 'Image URL'. Cross-checks Meta and Twitter images for full coverage.

Severity	Condition	Message shown in Studio
Error	URL field is empty	No OG image URL provided. Social shares will lack a visual preview.
Pass	URL is provided	OG image URL is set — good for social sharing.
Pass	Meta, OG, and Twitter images are all configured	All images set (Meta, OG, Twitter) — full coverage!
Warning	Meta image is missing	Meta image is missing — add it for search engine results.
Warning	Twitter image is missing	Twitter image is missing — add it for X (Twitter) cards.

Twitter Image (Upload)

The image used specifically in X (Twitter) cards. Shown when imageType is set to 'Upload Image'. Also checks alt text and cross-checks Meta/OG images.

Severity	Condition	Message shown in Studio
Error	No image asset uploaded	No Twitter image provided. Posts on X will lack a visual.
Pass	Image asset is present	Twitter image is set — good for X sharing.
Pass	Alt text field is filled	Alt text is set — good for accessibility.
Warning	Alt text field is empty	Consider adding alt text for better accessibility.
Pass	Meta, OG, and Twitter images are all configured	All images set (Meta, OG, Twitter) — full coverage!
Warning	Meta image is missing	Meta image is missing — add it for search engine results.
Warning	OG image is missing	OG image is missing — add it for Facebook/LinkedIn sharing.

Twitter Image URL

An external URL for the Twitter card image. Shown when imageType is set to 'Image URL'. Cross-checks Meta and OG images for full coverage.

Severity	Condition	Message shown in Studio
Error	URL field is empty	No Twitter image URL provided. Posts on X will lack a visual.
Pass	URL is provided	Twitter image URL is set — good for X sharing.
Pass	Meta, OG, and Twitter images are all configured	All images set (Meta, OG, Twitter) — full coverage!
Warning	Meta image is missing	Meta image is missing — add it for search engine results.
Warning	OG image is missing	OG image is missing — add it for Facebook/LinkedIn sharing.

Quick Navigation

Meta Title Meta Description Open Graph Title Open Graph Description X (Twitter) Title X (Twitter) Description Meta Image OG Image (Upload)OG Image URL Twitter Image (Upload)Twitter Image URL

← SEO Preview

See how the live SERP preview works while you edit.

Scoring & Tiers →

Learn how the health dashboard scores each document.

Was this page helpful?