How to group events into actions on PostHog
Quick Answer
Actions in PostHog allow you to group related events together for better analysis and tracking. You can create actions by navigating to the Actions tab, defining event criteria, and combining multiple events under a single action name.
Prerequisites
- Active PostHog account
- Events being tracked on your website or app
- Basic understanding of PostHog's event tracking
- Administrator or appropriate permissions in PostHog
Step-by-Step Instructions
1
Navigate to the Actions section
Log into your PostHog dashboard and click on Data Management in the left sidebar. Then select Actions from the submenu. This will display all existing actions and provide options to create new ones.
You can also access Actions directly from insights when analyzing events
2
Create a new action
Click the New Action button in the top right corner of the Actions page. A dialog box will appear asking you to name your action. Enter a descriptive name like
User Registration Flow or Purchase Completion that represents the group of events you want to track. Use clear, descriptive names that your team will easily understand
3
Define the first event criteria
In the action creation form, you'll see an Event or Action dropdown. Select Event and choose the first event you want to include from the list. You can filter events by typing in the search box. Add any additional filters using Property Filters to be more specific about when this event should trigger the action.
Start with the most important event in your sequence
4
Add multiple events to the action
Click Add another match group to include additional events in your action. Each match group represents an OR condition - the action will trigger when any of these events occur. Repeat the process of selecting events and adding property filters for each event you want to group together.
Use property filters to distinguish between similar events in different contexts
5
Configure action settings
Set the Action matching to determine how the events should be grouped. Choose Any event if you want the action to trigger when any of the specified events occurs, or configure more specific matching criteria. You can also set Post-hog webhook if you want to trigger external actions.
6
Test your action configuration
Before saving, use the Preview feature to see how many times your action would have been triggered in the past 7 days. This helps validate that your event grouping criteria are working correctly. Adjust the event selection or property filters if the numbers don't match your expectations.
A sudden spike or drop in expected triggers usually indicates incorrect filtering
7
Save and verify the action
Click Save Action to create your grouped events action. PostHog will start tracking this action going forward. Navigate to Insights and create a new trend analysis using your newly created action to verify it's capturing events correctly.
Actions only track events going forward from creation, not historical events
8
Use actions in analysis and dashboards
Your grouped events action can now be used across PostHog's analytics features. Add it to Dashboards, use it in Funnels to track conversion flows, or analyze it in Trends. You can also set up alerts based on action triggers in the Alerts section.
Actions make it easier to maintain consistent metrics across different team members and reports
Common Issues & Troubleshooting
Action not capturing expected events
Check your property filters are not too restrictive. Use the Preview feature to test different filter combinations and ensure event names match exactly.
Too many false positive triggers
Add more specific property filters to narrow down when the action should trigger. Consider using URL contains or element text filters for web events.
Action not showing historical data
Actions only track events from the creation date forward. If you need historical analysis, create insights using the individual events instead of the action.
Cannot find specific events in the dropdown
Ensure the events are actually being sent to PostHog by checking the Events tab in Data Management. Event names are case-sensitive and must match exactly.
Prices mentioned in this guide are pulled from current plan data and may change. Always verify on the official PostHog website before purchasing.