N
Nuxt•2mo ago
ok3n

Configure unhead v2 in Nuxt 15.6

Hi! In unhead v2, the template param is opt-in. Documentation says to: 
import { TemplateParamsPlugin } from 'unhead/plugins'

createHead({
  plugins: [TemplateParamsPlugin]
})
import { TemplateParamsPlugin } from 'unhead/plugins'

createHead({
  plugins: [TemplateParamsPlugin]
})
How can I do this in Nuxt 3.15.6 ? Should I create a new defineNuxtPlugin with unhead in it?
2 Replies
kapa.ai
kapa.ai•2mo ago
Hi @ok3n. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave: ---------------------- Yes, you're correct that in Unhead v2, the template params feature is now opt-in. In Nuxt 3, you can enable this feature by creating a Nuxt plugin that accesses the head instance and adds the plugin. According to the Nuxt 4 upgrade guide, you can implement this as follows: 
import { TemplateParamsPlugin } from '@unhead/vue/plugins'

export default defineNuxtPlugin({
  setup() {
    const unhead = injectHead()
    unhead.use(TemplateParamsPlugin)
  }
})
import { TemplateParamsPlugin } from '@unhead/vue/plugins'

export default defineNuxtPlugin({
  setup() {
    const unhead = injectHead()
    unhead.use(TemplateParamsPlugin)
  }
})
This plugin should be placed in your plugins directory. The injectHead() function gives you access to the Unhead instance that Nuxt is using internally, allowing you to add plugins to it. Note that the import path is @unhead/vue/plugins rather than unhead/plugins as shown in the vanilla Unhead documentation, since Nuxt uses the Vue integration of Unhead. If you're experiencing issues with this approach, you can alternatively enable legacy mode in your Nuxt config, which will restore the v1 behavior: 
export default defineNuxtConfig({
  unhead: {
    legacy: true,
  }
})
export default defineNuxtConfig({
  unhead: {
    legacy: true,
  }
})
However, using the plugin approach is recommended for forward compatibility. Nuxt 4 Upgrade Guide ---------------------- Note: you can ask me a follow up question by @ mentioning me again :speech_balloon: ----------------------
kapa.ai
kapa.ai•2mo ago
<@407208375349280778> Kapa.ai is still learning and improving, please let me know how I did by reacting below.

Did you find this page helpful?