Plausible Analytics
Plausible Analytics is a privacy-friendly analytics solution for Nuxt Apps, allowing you to track your website's traffic without compromising your users' privacy.
Script Stats
Nuxt Config Setup
The simplest way to load Plausible Analytics globally in your Nuxt App is to use Nuxt config. Alternatively you can directly use the useScriptPlausibleAnalytics composable.
export default defineNuxtConfig({
scripts: {
registry: {
plausibleAnalytics: {
domain: 'example.com'
}
}
}
})useScriptPlausibleAnalytics
The useScriptPlausibleAnalytics composable lets you have fine-grain control over when and how Plausible Analytics is loaded on your site.
const { proxy } = useScriptPlausibleAnalytics()
proxy.plausible('conversion', { props: { value: 1 } })Please follow the Registry Scripts guide to learn more about advanced usage.
First-Party Mode
This script supports First-Party Mode which routes all traffic through your domain for improved privacy and ad blocker bypass.
export default defineNuxtConfig({
scripts: {
firstParty: true,
registry: {
plausibleAnalytics: { domain: 'example.com'}
}
}
})To opt-out for this specific script:
useScriptPlausibleAnalytics({
domain: 'example.com',
scriptOptions: {
firstParty: false
}
})Example
Using Plausible Analytics only in production while using the proxy to send events.
<script setup lang="ts">
const { proxy } = useScriptPlausibleAnalytics()
// noop in development, ssr
// just works in production, client
function handleAction() {
proxy.plausible('conversion', { props: { value: 1 } })
}
</script>
<template>
<div>
<button @click="handleAction">
Send Event
</button>
</div>
</template>Self-hosted Plausible
If you are using a self-hosted version of Plausible, you will need to provide an explicit src for the script so that the API events are sent to the correct endpoint.
useScriptPlausibleAnalytics({
scriptInput: {
src: 'https://my-self-hosted-plausible.io/js/script.js'
}
})
PlausibleAnalyticsApi
export interface PlausibleAnalyticsApi {
plausible: ((event: '404', options: Record<string, any>) => void) &
((event: 'event', options: Record<string, any>) => void) &
((...params: any[]) => void) & {
q: any[]
}
}
Config Schema
You must provide the options when setting up the script for the first time.
export interface PlausibleAnalyticsOptions {
/**
* Unique script ID for your site (recommended - new format as of October 2025)
* Extract from: <script src="https://plausible.io/js/pa-{scriptId}.js"></script>
*/
scriptId?: string
/** Custom properties to track with every pageview */
customProperties?: Record<string, any>
/** Custom tracking endpoint URL */
endpoint?: string
/** Configure file download tracking */
fileDownloads?: {
fileExtensions?: string[]
}
/** Enable hash-based routing for single-page apps */
hashBasedRouting?: boolean
/** Set to false to manually trigger pageviews */
autoCapturePageviews?: boolean
/** Enable tracking on localhost */
captureOnLocalhost?: boolean
/** Enable form submission tracking */
trackForms?: boolean
}
export interface PlausibleAnalyticsDeprecatedOptions {
/**
* Your site domain
* @deprecated Use `scriptId` instead (new October 2025 format)
*/
domain?: string
/**
* Script extensions for additional features
* @deprecated Use init options like `hashBasedRouting`, `captureOnLocalhost`, etc. instead
*/
extension?: 'hash' | 'outbound-links' | 'file-downloads' | 'tagged-events' | 'revenue' | 'pageview-props' | 'compat' | 'local' | 'manual'
}
Note: The scriptId is found in your Plausible dashboard under Site Installation in your site settings.
Extracting your Script ID:
Plausible provides you with a script tag like this:
<script async src="https://plausible.io/js/pa-gYyxvZhkMzdzXBAtSeSNz.js"></script>
Your scriptId is the part after pa- and before .js:
scriptId: 'gYyxvZhkMzdzXBAtSeSNz'
// ^^^^^^^^^^^^^^^^^^^^^^^
// Extract from: pa-{scriptId}.js