A lightweight Alpine JS plugin for dynamically managing HTML <head> elements. Easily update meta tags, titles, and other head content on the fly 🦆
npm install alpinejs-head



Alpine JS Head is a simple plugin that lets you control your HTML
elements using Alpine JS.
This plugin lets you dynamically update:
- 📄 Page title
- 📝 Meta descriptions
- 🔍 SEO elements
- Simple: Change head elements without writing complex JavaScript
- Reactive: Head elements update automatically when your data changes
- Flexible: Use JSON, directives, or methods - whatever fits your style
- SEO-friendly: Update meta tags on the fly for better search results
``html
defer
src="https://unpkg.com/alpinejs-head@latest/dist/cdn.min.js"
>
`
`shell`
yarn add -D alpinejs-head
npm install -D alpinejs-head
`js
import Alpine from 'alpinejs'
import head from 'alpinejs-head'
Alpine.plugin(head)
Alpine.start()
`
You can use x-head.json to set the initial dynamic values and update them
later through Alpine JS data binding.
This approach is ideal when you need to manage multiple head elements at once or
when working with complex metadata structures.
`html`
The directive approach offers a clean, declarative way to manage head elements
directly in your HTML structure. It's perfect for components that need to update
metadata based on their state.
`html
x-data="{
title: 'Alpine JS Head Demo',
description: 'Dynamically control your page metadata with Alpine JS Head',
theme: '#00f'
}"
x-head.title="title"
x-head.meta.description="description"
x-head.meta.theme-color="theme"
>
x-model="description"
placeholder="Update meta description"
>
x-head will track the data of title, description, and theme and update
the HTML elements targeted through the modifiers.You can bind multiple head elements to the same component, making it easy to
update related metadata together.
$3
`html
x-data
type="button"
@click="$head('meta.description', 'Dynamically control your page metadata with Alpine JS Head')"
>
Description
``