Alpine JS Head is a simple plugin that lets you control your HTML <head>
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
<script
defer
src="https://unpkg.com/alpinejs-head@latest/dist/cdn.min.js"
></script>
<script defer src="https://unpkg.com/alpinejs@latest/dist/cdn.min.js"></script>yarn add -D alpinejs-head
npm install -D alpinejs-headimport 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.
<script x-data x-head.json type="application/json">
{
"title": "Alpine JS Head Demo",
"meta": [
{
"name": "description",
"content": "Dynamically control your page metadata with Alpine JS Head"
},
{
"name": "theme-color",
"content": "#00f"
}
]
}
</script>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.
<div
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"
>
<input type="text" x-model="title" placeholder="Change page title" />
<textarea
x-model="description"
placeholder="Update meta description"
></textarea>
<div>
<button type="button" @click="theme = '#00f'">Blue</button>
<button type="button" @click="theme = '#f00'">Red</button>
<button type="button" @click="theme = '#0f0'">Green</button>
</div>
</div>x-head will track the data of title, description, and theme and update
the HTML <head> elements targeted through the modifiers.
You can bind multiple head elements to the same component, making it easy to update related metadata together.
<button x-data type="button" @click="$head('title', 'Alpine JS Head Demo')">
Title
</button>
<button
x-data
type="button"
@click="$head('meta.description', 'Dynamically control your page metadata with Alpine JS Head')"
>
Description
</button>