All Docs
FeaturesMaking Tax DigitalUpdated March 10, 2026

Twitter Card Previews Now Enabled Across All Pages

Twitter Card Previews Now Enabled Across All Pages

Release: v1.0.372 · Category: SEO / Meta & Head

Overview

As of v1.0.372, agentOS now serves Twitter Card metadata on every page. When a link to the platform is shared on Twitter/X, it will render as a rich summary_large_image card — displaying a headline, description, and preview image — rather than a plain, unformatted URL.

This closes SEO control SEO-04, which identified a complete absence of metadata.twitter configuration across the application.

What Was Missing

Prior to this release, no twitter block existed in any page or layout metadata. Twitter/X's crawler would fall back to basic Open Graph tags at best, or render no card at all — meaning shared links appeared as bare URLs with no visual context.

Given that MTD compliance deadlines are time-sensitive news items frequently shared by accountants, tax professionals, and financial journalists, the lack of card previews represented a meaningful gap in organic reach.

What Was Added

The following twitter metadata block was added to the root layout (src/app/layout.tsx), making it the default for every page in the application:

export const metadata: Metadata = {
  // ...existing metadata...
  twitter: {
    card: 'summary_large_image',
    title: 'Making Tax Digital for UK Landlords & Self-Employed | agentOS',
    description: 'Automate quarterly HMRC submissions...',
    images: ['/og-image.png'],
  },
};

Key details

FieldValue
cardsummary_large_image
titleMaking Tax Digital for UK Landlords & Self-Employed | agentOS
descriptionAutomate quarterly HMRC submissions
images/og-image.png (shared with Open Graph / SEO-03)

Image Asset

The Twitter Card reuses the same /og-image.png introduced in SEO-03 for Open Graph tags. No additional image asset was required. The recommended dimensions for summary_large_image cards are 1200 × 630 px with a minimum of 300 × 157 px.

Overriding on Individual Pages

The root layout metadata acts as a site-wide default. Any page that needs a custom Twitter Card — for example, a specific help article about a quarterly submission deadline — can declare its own twitter block to override the defaults:

// src/app/some-page/page.tsx
export const metadata: Metadata = {
  twitter: {
    card: 'summary_large_image',
    title: 'Quarterly HMRC Submission Guide | agentOS',
    description: 'Step-by-step walkthrough for submitting your Q1 MTD return.',
    images: ['/og-quarterly-guide.png'],
  },
};

Next.js merges page-level metadata with the root layout, so only the fields you specify will be overridden — all other root defaults remain in place.

Validation

To verify Twitter Card tags are rendering correctly:

  1. Use the Twitter Card Validator and enter any page URL.
  2. Alternatively, inspect the page <head> and confirm the presence of tags such as:
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Making Tax Digital for UK Landlords & Self-Employed | agentOS" />
<meta name="twitter:description" content="Automate quarterly HMRC submissions..." />
<meta name="twitter:image" content="https://yourdomain.com/og-image.png" />

Related

  • SEO-03 — Open Graph tags and /og-image.png asset (prerequisite for this change)
  • SEO-04 — Twitter Card audit control (closed by this release)