Last updated:

If you are using Nuxt.js and want to track your application using PostHog this tutorial might help you out.

It will guide you through an example integration of PostHog using Nuxt.js.

Is this tutorial for me?

This tutorial is aimed at Nuxt.js users which run Nuxt in spa or universal mode. We are going to look at some minimal example code which should get you started quickly and provide a base for further customization.


To follow this tutorial along, you need to:

  1. Have deployed PostHog.
  2. Have a running Nuxt.js application

Minimal example

We are going to implement PostHog as a Nuxt.js integration which gives us the possibility to inject the posthog object and make it available across our application.

The first thing you want to do is to install the posthog-js library in your project - so add it using your package manager:

yarn add posthog-js


npm install --save posthog-js

After that we want to create a app in plugins/posthog/index.js

import posthog from 'posthog-js'
import Vue from 'vue'
export default function({ app: { router } }, inject) {
// Init PostHog
posthog.init('<ph_project_api_key>', {
api_host: '<ph_instance_address>',
capture_pageview: false,
loaded: () => posthog.identify('unique_id') // If you can already identify your user
// Inject PostHog into the application and make it available via this.$posthog (or app.$posthog)
inject('posthog', posthog)
// Make sure that pageviews are captured with each route change
router.afterEach(to => {
Vue.nextTick(() => {
/* Note: this might also be a good place to call posthog.register(...) in order to update your properties
on each page view
posthog.capture('$pageview', {
$current_url: to.fullPath

Finally, we need to activate it on the client side in our nuxt.config.js

plugins: [
{ src: './plugins/posthog', mode: 'client' }


By using the example code above you can now use PostHog across your app with this.$posthog or app.$posthog - depending on the context. Compare with the Nuxt.js docs on further details when to use app.$posthog or this.$posthog.

Let's say for example the user makes a purchase you could track an event like that:

<button @click="purchase">Buy</button>
methods: {
purchase() {


Was this page useful?

Next article


Objective Integrating PostHog with Retool. Why is this useful? Retool is a platform you can use to quickly build internal tools that leverage your data from different sources with little to no-code. Prerequisites To follow this tutorial along, you should: Have deployed PostHog . Have a Retool account Step-by-step instructions Retool app setup First, create a new app from the Retool dashboard: You will then need to create a new resource i.e. set up the configuration for where you'll pull the…

Read next article