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
<scriptdefersrc="https://unpkg.com/alpinejs-head@latest/dist/cdn.min.js"
></script><scriptdefersrc="https://unpkg.com/alpinejs@latest/dist/cdn.min.js"></script>yarn add -D alpinejs-head
npm install -D alpinejs-headimportAlpinefrom'alpinejs'importheadfrom'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.
<scriptx-datax-head.jsontype="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.
<divx-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"
><inputtype="text" x-model="title" placeholder="Change page title" /><textareax-model="description"
placeholder="Update meta description"
></textarea><div><buttontype="button" @click="theme = '#00f'">Blue</button><buttontype="button" @click="theme = '#f00'">Red</button><buttontype="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.
<buttonx-datatype="button" @click="$head('title', 'Alpine JS Head Demo')">
Title
</button><buttonx-datatype="button"
@click="$head('meta.description', 'Dynamically control your page metadata with Alpine JS Head')"
>
Description
</button>