Skip to Content
Social and Open GraphIssue 102

No twitter:creator handle

What Is This Issue

The twitter:creator meta tag specifies the X (Twitter) username of the content creator or author. This links individual articles or posts to the author’s personal X account when content is shared on the platform.

This issue checks whether your page has the twitter:creator tag implemented (for article-type content with identifiable authors). A passing implementation must include:

  • twitter:creator - The X handle of the content creator or author (with or without @ symbol)

Example of passing implementation:

<meta property="og:type" content="article" />
<meta name="twitter:creator" content="@johndoe" />

Why Is This Important

The twitter:creator tag is valuable for author attribution and personal branding:

  • Author attribution: Gives proper credit to content creators on X
  • Personal branding: Helps authors build their personal X presence
  • Account linking: Connects content to author’s X profile
  • Follow promotion: Makes it easier for readers to follow the author
  • AI Search / AEO: AI systems may use creator information for entity recognition

Without the twitter:creator tag:

  • Authors don’t receive attribution on X shares
  • Missed opportunity for authors to promote their X accounts
  • Reduced personal branding for content creators

Resolving this issue improves author attribution on X and contributes to a higher overall SEO health score by strengthening creator signals.

How XeoPix Detects This

XeoPix checks for the twitter:creator tag by:

  1. Fetching the page HTML after following all redirects
  2. Identifying article pages: Checking if og:type is “article” or page appears to be article-like
  3. Parsing the <head> section to extract the meta tag with name="twitter:creator"
  4. Validating presence: Checks that the tag exists on article pages with identifiable authors
  5. Validating content: Ensures the tag has a non-empty value
  6. Flagging the issue if the tag is missing on article pages or is empty

The detection is performed on the raw HTML response without JavaScript execution, matching how X’s crawler sees your pages.

How To Fix

  1. Add the twitter:creator tag to your HTML <head> section (for articles with authors):

    • Use the author’s X handle (e.g., “@johndoe” or “johndoe”)
    • Include the @ symbol for clarity (optional but recommended)
    • Ensure the handle matches the author’s actual X account

  2. Only use for article-type content:

    • Set og:type to “article” on pages with this tag
    • Don’t add to homepage, product pages, or non-article content

  3. Verify author accounts:

    • Double-check that handles are correct and active
    • Each author should have their own X account

  4. Test your implementation:

    • Use X Card Validator to verify the creator handle is detected
    • Tweet the URL and check if the author is attributed

What We Store

Storage Level

Page Level

Database Table / Prisma Model

SocialOpenGraphData

Stored Fields

FieldTypeDescription
twitterCreatorString?Twitter creator handle (twitter:creator)

Detection Dependencies

  • HTML Document
  • Meta Tags (twitter:creator)

Examples

Example 1: Missing Twitter Creator Handle

Problematic state (what fails):

<meta property="og:type" content="article" />
<!-- Missing twitter:creator tag -->

Corrected state (what passes):

<meta property="og:type" content="article" />
<meta name="twitter:creator" content="@johndoe" />

Example 2: Creator Handle Mismatch

Problematic state (what fails):

<!-- Author is Jane Smith but handle is for John Doe -->
<meta name="twitter:creator" content="@johndoe" />

Corrected state (what passes):

<!-- Handle matches actual author -->
<meta name="twitter:creator" content="@janesmith" />

Example 3: Non-Article Page with Creator Tag

Problematic state (what fails):

<meta property="og:type" content="website" />
<meta name="twitter:creator" content="@johndoe" />
<!-- Should not be on non-article pages -->

Corrected state (what passes):

<meta property="og:type" content="website" />
<!-- Remove creator tag from non-article pages -->

Unit Test

Test File

xeopix-crawling-v2/__tests__/seo-audit-checks/socialOpenGraph/issue-128-twitter-creator-handle.test.js

Purpose

Validates that the crawler detects pages missing the twitter:creator meta tag.

Tested Function

runSocialOpenGraph()

Issue Information

  • Issue Number: 128
  • Issue Code: twitter_creator_handle
  • Toggle Group: socialOpenGraph

Test Scenarios

Positive Test Cases

  • twitter:creator is present (e.g., @author) → no issue detected.

Negative Test Cases

  • twitter:creator is missing from the page → issue detected with message "Twitter creator handle meta tag is missing".

Boundary Cases

No boundary cases exist in the test.

Edge Cases

  • Empty HTML: The function handles an empty string without throwing.

Expected Outcome

Pass

The issue should not be reported when the twitter:creator meta tag is present in the page HTML.

Fail

The issue should be reported when the twitter:creator meta tag is missing.

Validation

  • Correctly detects the absence of the twitter:creator tag.
  • Does not report a false positive when twitter:creator is present.
  • Handles empty HTML gracefully without crashing.
  • xeopix-crawling-v2/toggleGroups/socialOpenGraph.js
  • xeopix-crawling-v2/issueCodes.js

Coverage Summary

  • Covers present and missing twitter:creator scenarios.
  • Includes resilience test for empty input.

References

Last updated on
Issue 101Issue 103