Strapi Plugin for Pirsch

A Strapi v5 plugin that provides an embedded Pirsch analytics dashboard within the Strapi admin interface.

Installation

npm install @fresh.codes/strapi-plugin-pirsch

Configuration

Configure Dashboard URL

1. Navigate to Settings → Pirsch Analytics in your Strapi admin
2. Enter your Pirsch Access Link (e.g., https://your-dashboard.pirsch.io)
3. Click Save Settings

Note: There are additional query params you can add to your access link (like &ui=hide).

Content Security Policy (Optional)

If you have the strapi::security middleware enabled, update your config/middlewares.ts:

export default [
  {
    name: 'strapi::security',
    config: {
      contentSecurityPolicy: {
        directives: {
          'frame-src': ["'self'", 'https://*.pirsch.io'],
        },
      },
    },
  },
]

If you're using a custom domain like stats.example.com then you'll need to tweak the CSP policy a bit more to allow for the pirsch api calls to work:

export default [
  {
    name: 'strapi::security',
    config: {
      contentSecurityPolicy: {
        directives: {
          'frame-src': ["'self'", 'https://stats.example.com'],
          'connect-src': ["'self'", 'https://api.pirsch.io'],
        },
      },
    },
  },
]

Permissions

The plugin registers two permissions that can be managed in Settings → Roles & Permissions:

• Access the Pirsch Analytics Dashboard: Controls who can view the main analytics dashboard
• Update Pirsch Analytics Settings: Controls who can configure the dashboard URL

By default, only Super Admins have access. You can grant permissions to other roles as needed.

License

MIT License

Made by Fresh Codes.

Don't have Pirsch yet? Sign up here (affiliate link).