SEO Auditor — validates that the HTML page title is present and within the recommended 15–70 character range.
SEO
Titles that search engines can display in full and that describe the page.
Usability
Browser tabs and bookmarks show a unique, readable title instead of a blank or truncated one.
<title> is the primary snippet search engines show in results and the label browsers use for tabs and bookmarks. This auditor fetches the page, extracts the title with jsoup, and checks its presence, length, structure, and quality: duplicate title tags, CMS placeholder copy, all-caps titles, titles unrelated to the H1, and titles missing the site name.
How it works
The auditor loads the audited URL and evaluates the first<title> element:
- Fetch — requests the HTML with jsoup (including HTTP Basic Auth when provided).
- Extract — reads
document.selectFirst("title")and trims surrounding whitespace; also counts<title>elements, reads the first<h1>, and derives the site name from the hostname (first label after strippingwww.). - Rules — applies missing, empty, excessively long (over 100), and duplicate-tag checks (FAIL), then too-short (1–14), too-long (71–100), placeholder, all-caps, H1-mismatch, and missing-brand checks (WARNING). Quality rules are skipped when the title is missing or empty.
- Aggregate — any
FAILrule wins overWARNING; if every rule passes, the audit isSUCCESS.
ERROR response rather than a title finding.
What it audits
Every row maps to onecheckRule* method and one CheckCode. CheckCode suffixes use status ranges: 200 success, 300–399 warning, 400–499 fail.
Output documentation
Risks and considerations
Search visibility
- Missing or empty titles force search engines to invent a snippet, which often mismatches the page and lowers click-through.
- Titles over 70 characters are typically truncated in SERPs; over 100 characters are almost never shown in full.
Uniqueness and intent
- A two-word title like
"Hi"does not describe the page. Expand it with the primary topic so results and tabs are distinguishable. - Placeholder titles such as
UntitledorWelcome to Liferaysignal an unfinished page and are reused across sites, so they never differentiate the result. - Reusing the same generic title across many URLs collapses rankings and analytics into one unhelpful label.
Consistency and trust
- When the title and the H1 say different things, users who click the search result land on a page that does not match the snippet, increasing bounces.
- Including the site name in the title (usually as a suffix) builds recognition in results; the auditor infers the name from the hostname and treats spaces or hyphens as equivalent (
37auditsmatches37 Audits). A title that uses a different spelling still warns. - All-caps titles read as shouting, are harder to scan, and some engines rewrite them anyway.
Whitespace and encoding
- Leading and trailing whitespace is trimmed before length is measured; a title of only spaces is treated as empty.
- Character count is the Java string length of the trimmed text, not a pixel-width estimate used by some SERP renderers.
- Only the first
<title>element is measured; extra title tags are flagged separately and otherwise ignored, matching browser behavior.