@unhead/addons
3.4.3 · 13 Oct 2026MIT68.7k / weekRepositoryHomepagenpmAtom feed
213 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 2.x
2.0.12
6 Jul 2025react: Force invalidation on entry disposal
2.0.11
24 Jun 2025Allow non-standard meta tags to be intentionally duped
2.0.10
23 May 2025Safer meta array deduping
2.0.9
18 May 2025unhead: Normalize canonicalHost only once in canonical plugin
2.0.8
16 Apr 20252.0.7
16 Apr 2025schema-org:
unheadhoisting issue
2.0.6
16 Apr 2025ssr: Less aggressive encoding of non-title tags
2.0.5
7 Apr 2025vue: Use
setTimeoutas render's debounced delayer
2.0.4
6 Apr 2025InferSeoMetaPlugin: Template param replacement broken
2.0.3
2 Apr 2025InferSeoMetaPlugin: Function title templates not respected
react: Ensure
<Head>updates context immediately for SSR compatibilityreact: Update unhead context on initial <Head> render
Bug Fixes
InferSeoMetaPlugin: Function title templates not respected
react: Ensure
<Head>updates context immediately for SSR compatibilityreact: Update unhead context on initial <Head> render
react: Process tag content and memoize elements
react: Support >= React v18
2.0.2
26 Mar 2025Export extra server/client types
2.0.1
25 Mar 2025scripts: Preserve function overload types
unhead: Respect truthy
data-*empty strings
2.0.0
23 Mar 2025- Breaking
Only handle promise input when opted in
- Breaking
Client / server subpaths
- Breaking
Drop implicit context
Unhead v2
The latest major is now stable! Check out the v2 release notes and the Vue migration guide or TypeScript migration guide.
Breaking Changes
- Breaking
Only handle promise input when opted in
- Breaking
Client / server subpaths
- Breaking
Drop implicit context
- Breaking
Property debounce dom updates
- Breaking
Properly debounce dom updates
- Breaking
Drop
CJSexports - Breaking
V2 core rewrite
- Breaking
core: Remove
HashHydrationPlugin - Breaking
core:
unctxfallback context - Breaking
core: Default capo sorting
- Breaking
core: Drop
vmid,hid,childrenbodykeys - Breaking
core: Make
TemplateParamsPluginopt-in
Features
Vanilla function resolves
Angular support
Angular support
Default important head tags
Solid.js support
core: Whitelist styles with
useHeadSafe()core: Whitelist styles with
useHeadSafe()core: Canonical plugin
Bug Fixes
Export
InferSeoMetaPluginfromunhead/optionalPluginsHandle boolean props
Support legacy
Clear resolved input when patching a node
- Deprecated
Deprecate
@unhead/schema - Deprecated
Deprecate
@unhead/shared SerializableHeadinput support and exportsV1 deprecations
Cjs compat
Validate correct type exports
Track title side effects
Avoid normalizing class and style strings
Ensure json strings are properly encoded
Use a backwards-compatible alternative to
Object.hasOwnaddons: Stabilize useSeoMeta tree shaking
addons: Stabilize
useSeoMeta()->useHead()transformeraddons: Implicit peer dependencies
core: Avoid recursive function patching
core: Broken
styletypescore: Broken promise resolving for proxy objects
core: Clone tags for immutability
core: Server template params missing from SSR payload
- Breaking
core,types: Revert breaking change on
Headtype core,vue: Missing subpath exports
- Deprecated
core,vue: Deprecate server composables
Performance
Isolate plugin logic
Drop
packrupdependencyPrefer mapped entries
Mark explicit no side effects on
createHeadvariantscore: Make
AliasSortingPluginopt-incore: Normalize entries once
- 1.x
1.11.21
19 Nov 2026v1: Harden useHeadSafe input sanitization
1.11.15
7 Jan 2025schemaOrg: Resolve nodes with custom nodes
vue2:
head()not called with vm contextAvoid inlining dependencies
1.11.14
10 Dec 2024useScript: Allow
load()to be called again onceremove()is called
1.11.13
25 Nov 20241.11.12
25 Nov 2024schema: Prefer ReturnType instead of infer
schema-org: Mark
unheadas peer dependencyschema-org: Duplicate tag generated in some instances
1.11.11
1 Nov 2024Title getting encoded when using titleTemplate
schemaOrg: Avoid rendering empty schema graph
schemaOrg: Duplicate
ReadAction's for WebPage
1.11.10
16 Oct 2024addons: Avoid transforming wrong composables
1.11.9
14 Oct 2024useScript: Avoid calling proxy functions before loaded
1.11.8
14 Oct 2024schema-org: Avoid exporting
/*useScript: Allow custom
headinstanceuseScript: Avoid registering promises server-side
Bug Fixes
schema-org: Avoid exporting
/*useScript: Allow custom
headinstanceuseScript: Avoid registering promises server-side
useScript: Don't throw exceptions on failures
useScript: Singleton abort promise
useScript,vue: Abort load trigger on scope dispose
1.11.7
29 Sep 2024schema-org: Subpath export types
1.11.6
16 Sep 2024scripts,vue: Only unwatch if initialized
1.11.5
15 Sep 2024scripts,vue: Avoid cancelling new triggers
1.11.4
15 Sep 2024scripts: Prefer boolean promise fulfillment
scripts: Clean up expired promises
scripts,vue: Prefer ref promises
1.11.3
15 Sep 2024schemaOrg: Maybe resolve
/vuesubpath type exportsvue: Merge
headfunctions with vm context
1.11.2
9 Sep 2024Avoid normalising truthy
data-xvalues"
1.11.1
8 Sep 2024schemaOrg: Expose deduping config
tagDuplicateStrategyschemaOrg: Avoid duplicates when merging
schemaOrg: Resolve relation
@id's with path
1.11.0
8 Sep 2024- Deprecated
unhead: Deprecate
useHeadpromises, support falsy values unhead: Drop
keyoverrides for unique metaunhead: Avoid normalising truthy
data-xvalues
:information_source: This is a minor release with many bug fixes, while there are no explicit new features, an effort should be made to checking your tags after upgrading.
This will be last minor before work begins on v2, check the roadmap and feel free to make suggestions.
Bug Fixes
unhead: Drop
keyoverrides for unique meta- Deprecated
unhead: Deprecate
useHeadpromises, support falsy values unhead: Avoid normalising truthy
data-xvaluesunhead: Client-side fallback to root server only title
unhead: Parse template params in
titleTemplatefunctionsunhead: Avoid duplicate tags from being generated
Performance
Avoid duplicate
entries:updatedcalls
1.10.4
3 Sep 2024vue,scripts: Support parallel triggers
1.10.3
3 Sep 2024scripts,vue: Always expose status as a ref
1.10.2
2 Sep 2024scripts: Re-register Vue lifecycles on script reuse
1.10.1
2 Sep 2024schema-org: Correct invalid ThumbnailUrl in Video tag
scripts: Support re-registering the load trigger
scripts: Lifecycle events for triggers
1.10.0
20 Aug 2024- Deprecated
scripts: Deprecate implicit proxy and
$script scripts: Safer lifecycle hooks
onLoaded,onErrorscripts: Infer types from
use()
Features
- Deprecated
scripts: Deprecate implicit proxy and
$script scripts: Safer lifecycle hooks
onLoaded,onError
Bug Fixes
scripts: Infer types from
use()scripts: Avoid type wrapping promises
scripts: Avoid type wrapping promises
scripts: Avoid returning explicit undefined values
scripts:
servertrigger not syncing loading statusscripts: Avoid vue overriding status with ref
unhead: Mark meta charset as safe
Performance
Optimize hot paths and reduce overhead for low-end devices
1.9.16
14 Jul 2024addons: Honour titleTemplate
tagPriority
1.9.15
4 Jul 20241.9.14
20 Jun 2024unhead:
styleside effect not clearing
1.9.13
13 Jun 2024schema-org: Avoid casting
MonteraryAmountvalue toQuantitativeValueschema-org: Drop peerDependencies
1.9.12
2 Jun 2024scripts: Lazily trigger
beforeInit"unhead: Missing types for
falseattrsscripts: Process triggers async on animation frames
1.9.11
22 May 2024scripts: Lazily trigger
beforeInit
1.9.10
7 May 2024scripts: Still resolve load promise when no
use()is provided
1.9.9
3 May 2024scripts: Forward only defined API props
1.9.8
1 May 2024scripts: Avoid nulled proxy api after script load
scripts: Safer and more powerful proxying
1.9.7
19 Apr 2024scripts: Allow properties to be returned async
1.9.6
19 Apr 2024scripts:
beforeInithook for script depsscripts: Bind to onMounted as default Vue trigger
scripts: Attempt resolving api before loading
Bug Fixes
scripts:
beforeInithook for script depsscripts: Bind to onMounted as default Vue trigger
scripts: Attempt resolving api before loading
Performance
scripts: Drop unsupported inline HTML usage
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.