How to Create Tracked Events

Last Updated January 7, 2026

Brief Overview

Tracked Events let you measure meaningful user actions across your application, such as completing a signup, submitting a form, or visiting a specific page.

You can create Tracked Events in the Events page either by defining event rules manually or by capturing elements directly from the application using the WalkMe Editor.

Access

You can create Tracked Events from the Events page in the WalkMe Console.

Insights Events Page

How It Works

Tracked Events use Digital Experience Analytics (DXA) to track specific user actions on your website or application.

They allow you to follow end-user completion of processes with or without WalkMe content present, making them useful for measuring behavior before and after WalkMe is deployed.

Tracked Events can be created either by manually defining tracking rules or by capturing elements directly from the application.

About Insights Tracked Events

Create a Tracked Event Manually

Use manual creation when you need precise control over what data is tracked, such as page visits, specific elements, or WalkMe content actions.

  1. Select Create Event on the Events page
  2. Select Tracked Event
  3. Select Create Manually

  4. Enter a name for the Tracked Event

  5. Select a system

  6. Select what you want to track:
    • Elements
    • Content
    • Page

Track elements (Manual)

Use the Elements data type to track interactions with specific HTML elements.

Note

DXA must be enabled to use the Elements data type.

  1. Select an element interaction type:
    • Click/Tap
    • Input
  2. Use the condition builder to define element rules:
    • Label
    • Class
    • ID
    • CSS selector
  3. Enter or select values for each condition
  4. Optional: Add page filters to narrow the data set
  5. Select Create

Best practices

  • Select the highest-level element users interact with
  • Ensure the definition is unique to avoid aggregating unrelated actions
  • Avoid dynamic or randomized classes and IDs

CSS selectors

CSS selectors allow you to precisely define which HTML elements should be tracked.

When to use

  • Only when label, class, or ID rules are insufficient
  • Requires basic familiarity with CSS

Supported syntax

  • ID: #idName
  • Class: .className
  • Tag: div
  • Attribute: [attribute='value']
  • Combinations: div.class1.class2 #someId[attribute=value]

Best practices

  • Avoid dynamically generated attributes
  • Avoid long class names and IDs
  • Test selectors using the real-time validation message

Limitations

  • Classes longer than 35 characters are not collected
  • IDs longer than 40 characters are not collected
  • Existing events using deprecated operators remain visible but cannot be edited

Track WalkMe content (Manual)

Use the Content data type to track interactions with WalkMe items.

  1. Select a content type (for example, Launcher or ShoutOut)
  2. Select specific items
  3. Select one or more actions:
    • Click/Tap
    • Input
  4. Select Create

Track page visits (Manual)

Use the Page data type to track visits to specific pages.

Note

Page collection must be enabled.

  1. Use the condition builder to define page rules:
    • URL
    • Path
    • Hash
    • Domain
    • Query
  2. Enter values
  3. Add additional conditions if needed
  4. Select Create

Best practices

  • Use Path instead of full URLs when query parameters are dynamic
  • Use wildcards (*) to ignore changing URL segments
  • Use full URLs only when multiple URL components are required

Create a Tracked Event by Capture

Use capture when you want to define a Tracked Event by selecting an on-screen element instead of writing rules manually.

  1. Select Create Event
  2. Select Tracked Event
  3. Select Create by Capture

  4. Select a system

  5. Enter a URL Destination

  6. Select Start Capture

    Note

    The WalkMe Editor must be open to start capturing.

  7. Capture the element

  8. Enter an event name

  9. Select Done

The Tracked Event appears in the Management tab.

Best Practices

  • Validate definitions using real-time data feedback
  • Use Tracked Events as building blocks for funnels and advanced Insights reporting
  • Review event definitions periodically to ensure continued accuracy

Collect Baseline Data with Engaged Elements or Tracked Events

Technical Notes

Prerequisites

  • Full DXA is required for retroactive Click and Input tracking
  • Page collection must be enabled for Page tracking
  • The latest editor extension is required for capture
  • Users must have access to the relevant system

Operator limitations

  • Only the is equals operator is supported for new Tracked Events
  • Deprecated operators are supported for existing events but cannot be edited
  • Wildcards are supported (for example: /insights/*)

Performance and filters

  • Use the Contains operator only when necessary
  • Integration filters apply only when events belong to the same system
  • When creating rules manually, use either AND or OR, not both

Support and environment limits

  • Only the Production environment is supported
  • Desktop and mobile systems are not supported
  • Mobile web data is not supported
  • Action Bot, Quiz, and TeachMe are not supported
  • Insights officially supports Chrome

Was this article helpful?

Thanks for your feedback!

Be part of something bigger.

Engage with peers, ask questions, share ideas

Ask the Community
×
The trademarks and product names of Workday, Inc., including the WORKDAY® mark, are the property of Workday, Inc. WalkMe is not affiliated with Workday, Inc., nor does Workday, Inc. sponsor or endorse WalkMe, its services or its website.