Resolving On Page Insights

Private Beta Feature

On Page insights in SEO & AEO Studio fall into three categories: Content Structure, Images and Media, and Page Metadata.

For information about the dashboard and the Insights table, see Reviewing Insights. For information about Insight Details, see Resolving Insights.

Content Structure

Insight	Impact	Detection Criteria	Recommended Action
Missing `<h1>` Tag	High	The page has no `<h1>` tag.	Add a single `<h1>` that includes the primary keyword and complements the page’s `<title>` without repeating it. Place it at the top of the main content.
Multiple `<h1>` Tags	Medium	The page has more than one `<h1>`.	Keep the most relevant `<h1>` and change the others to `<h2>` or `<h3>`.
Low Content Pages	Medium	The page’s main content area has fewer than 200 words.	Expand the page with background, examples, and answers to readers’ questions until it covers the topic fully.
Heading Hierarchy Skips	Low	The page skips a heading level, such as an `<h3>` whose closest preceding heading is an `<h1>`.	Change the heading levels so they descend hierarchically (`<h1>` to `<h2>` to `<h3>`) without skipping levels.
Empty Heading Tags	Low	The page has a heading tag with no text.	Add descriptive text to each empty heading, or remove the tag entirely.
Excessively Long Headings	Low	The page has a heading longer than 70 characters.	Shorten each heading to 70 characters or fewer, leading with its most search-relevant phrase. Move supporting context into the paragraph below it.

Length checks on headings count each double-width character, such as a Chinese, Japanese, or Korean character, as two.

Images and Media

Insight	Impact	Detection Criteria	Recommended Action
Missing `alt` Attributes on Images	High	One or more `<img>` tags have no `alt` attribute.	Add a descriptive `alt` attribute of 125 characters or fewer to each meaningful image, and set `alt=""` on decorative images.
Empty `alt` Attributes on Images	Medium	One or more images use `alt=""`.	Add descriptive `alt` text to each flagged image that carries content, and leave `alt=""` only on purely decorative images.
`alt` Text Too Long	Low	One or more `alt` attributes exceed 125 characters.	Shorten the `alt` text to 125 characters or fewer. Move longer descriptions into a caption or surrounding body text.
Missing Image URLs	Low	One or more `<img>` tags have no `src` attribute, or an empty one.	Select an image for the empty image field in the template, editable element, or fragment that renders it. If the page doesn’t need the image, remove the element.

Page Metadata

In Liferay DXP, fix these insights in the page’s settings. Page titles and meta descriptions are configured on the SEO tab, and the Open Graph image is configured on the Open Graph tab.

Insight	Impact	Detection Criteria	Recommended Action
Missing or Empty `<title>` Tag	High	The page’s `<title>` tag is missing or empty.	Add a unique, descriptive title of 30 to 60 characters that includes the primary keyword. Or use Autofix.
Missing or Empty Meta Description Tag	Medium	The page’s `<meta name="description">` tag is missing or its `content` attribute is empty.	Add a meta description of 70 to 160 characters that summarizes the page. Or use Autofix.
Missing Open Graph Image Tag	Medium	The page’s `<meta property="og:image">` tag is missing or its `content` attribute is empty.	Set an image in the page’s Open Graph settings, or set a default for all of the site’s pages in its Open Graph settings. Use a 1200x630 px image to ensure proper rendering across social platforms and messaging clients.
Too Long or Too Short `<title>` Tag	Low	The `<title>` is shorter than 30 characters or longer than 60.	Rewrite the title to 30 to 60 characters, leading with the primary keyword. If it’s too short, add a qualifier or a secondary keyword.
Too Long or Too Short Meta Description Tag	Low	The meta description is shorter than 70 characters or longer than 160.	Rewrite the description to 70 to 160 characters, with the most important point first. Or use Autofix.
Page Title Identical to `<h1>` Text	Low	The `<title>` matches the text of the page’s first `<h1>`, ignoring case.	Rewrite the title to complement the `<h1>` without duplicating it word for word (for example, by varying keyword phrasing).