Analytics

All EBRAINS Design System components come with built-in analytics integration. Every UI component automatically fires custom events to track user interactions without additional configuration.

How It Works

Integrated Analytics

All UI Components in the design system are instrumented to send analytics events. When a user clicks a button, interacts with a card, or navigates via a link, a custom event is fired automatically.

Custom Events

Each component fires events with details such as:

• Category — the component type (e.g., ui-component)
• Action — the interaction performed (e.g., click)
• Tag — the component tag name (e.g., eds-link)
• Name — contextual identifier built from the component’s content

Matomo Integration

For analytics to work, Matomo must be initialized in your application. The design system does not reinitialize Matomo — once initialized, all components will automatically use the existing Matomo instance.

Your only responsibility is to ensure Matomo is initialized in your application’s startup code.

Dashboard

Analytics data is sent to our Matomo instance, available at stats.ebrains.eu. There you can monitor usage, review KPIs, and inform application updates based on real usage data.

Example Event Data

When a component is interacted with, it fires an event with this structure:

Matomo records this as:

Setup

To get your Matomo tracking snippet, submit a request via the EBRAINS Stats Request form. You will receive a site ID and tracking configuration for your application.

Once you have your site ID, ensure Matomo is loaded before any EBRAINS components render.

Once Matomo is initialized, all EBRAINS components will automatically send events — no per-component configuration needed.