fix(addons): respect user-provided twitter:card in InferSeoMetaPlugin (#681)

harlan-zw · web-flow · commit 77ace2157809 · 2026-03-10T23:54:54.000+11:00
Make twitter:card push conditional so that `twitterCard: false` option properly suppresses output. User-provided values already take precedence via `tagPriority: 'low'` on the plugin entry. Adds regression tests for both override scenarios. Closes #555
diff --git a/packages/unhead/src/plugins/inferSeoMetaPlugin.ts b/packages/unhead/src/plugins/inferSeoMetaPlugin.ts
@@ -23,13 +23,19 @@ export interface InferSeoMetaPluginOptions {
 
 export function InferSeoMetaPlugin(options: InferSeoMetaPluginOptions = {}) {
   return defineHeadPlugin((head) => {
+    if (options.twitterCard !== false) {
+      head.push({
+        meta: [
+          {
+            name: 'twitter:card',
+            content: options.twitterCard || 'summary_large_image',
+            tagPriority: 'low',
+          },
+        ],
+      })
+    }
     head.push({
       meta: [
-        {
-          name: 'twitter:card',
-          content: options.twitterCard || 'summary_large_image',
-          tagPriority: 'low',
-        },
         {
           'property': 'og:title',
           'tagPriority': 'low',
diff --git a/packages/unhead/test/unit/plugins/infer-seo-meta.test.ts b/packages/unhead/test/unit/plugins/infer-seo-meta.test.ts
@@ -1,5 +1,6 @@
 import { renderSSRHead } from '@unhead/ssr'
 import { describe, it } from 'vitest'
+import { useHead, useSeoMeta } from '../../../src'
 import { InferSeoMetaPlugin, TemplateParamsPlugin } from '../../../src/plugins'
 import { createHead } from '../../../src/server'
 
@@ -331,4 +332,44 @@ describe('inferSeoMetaPlugin', () => {
       <meta property="og:title" data-infer="" content="Nuxt SEO – Hello World">"
     `)
   })
+
+  it('user twitterCard via useSeoMeta overrides plugin default (#555)', () => {
+    const head = createHead({
+      disableDefaults: true,
+      plugins: [InferSeoMetaPlugin()],
+    })
+
+    useSeoMeta(head, { twitterCard: 'summary' })
+
+    const result = renderSSRHead(head)
+    expect(result.headTags).toMatchInlineSnapshot(`"<meta name="twitter:card" content="summary">"`)
+  })
+
+  it('user twitter:card via useHead overrides plugin default (#555)', () => {
+    const head = createHead({
+      disableDefaults: true,
+      plugins: [InferSeoMetaPlugin()],
+    })
+
+    useHead(head, { meta: [{ name: 'twitter:card', content: 'summary' }] })
+
+    const result = renderSSRHead(head)
+    expect(result.headTags).toMatchInlineSnapshot(`"<meta name="twitter:card" content="summary">"`)
+  })
+
+  it('plugin twitterCard: false disables twitter:card output (#555)', () => {
+    const head = createHead({
+      disableDefaults: true,
+      plugins: [InferSeoMetaPlugin({ twitterCard: false })],
+    })
+
+    head.push({ title: 'My Title' })
+
+    const result = renderSSRHead(head)
+    expect(result.headTags).not.toContain('twitter:card')
+    expect(result.headTags).toMatchInlineSnapshot(`
+      "<title>My Title</title>
+      <meta property="og:title" data-infer="" content="My Title">"
+    `)
+  })
 })
