BlogFeatures
Why Jira's Custom Events Are Your Next Strategic Move

Why Jira's Custom Events Are Your Next Strategic Move

Learn how to create and manage custom events in Jira with this practical step-by-step guide for administrators. Start mastering your projects today!

September 10, 2025
0
min read
Why Jira's Custom Events Are Your Next Strategic Move
Why Jira's Custom Events Are Your Next Strategic Move
Daria Spizheva | ActivityTimeline's Blog Author
Daria Spizheva
Content Marketing Manager
In this article

Jira is the undisputed heavyweight champion for managing software development. But what about all the other work that keeps a company running? What about the crucial internal planning sessions, client calls, or team-building activities that don't fit neatly into a bug or a story? For too long, these have been invisible activities—tasks that consume time but exist outside a formal workflow, making it difficult to get a complete picture of an employee's workload.

This is a problem ActivityTimeline solves with its powerful custom events feature. By allowing you to create and tailor new event types to match your specific internal processes, you can transform these invisible tasks into trackable, reportable data. This article will walk you through how to use Jira custom events to gain total control over your planning and reporting.

Custom events provided by default

TL;DR

Jira's default functionality is limited to issue-based work, leaving many internal activities untracked. ActivityTimeline's custom events feature allows you to create new event types, such as "Client Call" or "Training Session," to capture this previously invisible work. These events appear on your team's timeline and can be included in reports and timesheets, giving managers a comprehensive view of all activities. This customization helps organizations get a more accurate picture of how time is spent, leading to more informed decisions and streamlined processes.

Beyond Jira Issues: Capturing All Your Work

The core idea behind this feature is that not all valuable work is a Jira issue. Activities like vacations, sick leave, team meetings, and strategic planning sessions are critical for a healthy and productive team, yet they often exist only in external calendars or forgotten spreadsheets. ActivityTimeline provides a centralized way to bring these into your project management ecosystem.

Booking event description page

The ability to add and define your own custom event types allows you to tailor ActivityTimeline to the way your organization actually works. This feature is a direct result of insights lifted by community discussions and requests from users who needed a more holistic view of their teams' time.

{{rich-cta-2}}

Step-by-Step: Creating a New Custom Event Type

Creating a new event is a straightforward process. It allows you to define an event that perfectly matches an activity common to your team, ensuring that all work, both in and out of Jira, is tracked consistently.

  1. Navigate to Configurations > Events > Timeline Event Types. This tab provides a list of all existing event types.
  2. Click the "Create Custom Event Type" button. A dialog will appear, prompting you to define the new event.
  3. Enter a name and description for your new custom event type. The description is helpful for ensuring everyone on your team can understand its purpose.
  4. Choose a base event type. This is a foundational step where you select a system event like BOOKING, DAY_OFF, HOLIDAY, or NOTE. Your new event will inherit the properties of this base type. For example, choosing BOOKING as your base would allow you to capture a specific amount of time per day.
  5. Set a default category. You can set a default worklog category for the event, making a "Meeting" event type automatically "Non-Billable" and a "Project Work" event type "Billable".
  6. Save your changes. Your new custom event type is now available to all users in the event creation menu. Admins may approve or dismiss the event if necessary.
Approval badge for admins

Use Cases and Benefits

Once configured, these custom events become powerful tools for planning and reporting.

  • Enhanced Tracking: Custom events enable granular tracking of diverse work categories that fall outside Jira issues. You can create events for "Admin Tasks" or "Training Session" and see precisely how much time is spent on these activities. This allows for a deeper workload analysis and helps a manager allocate resources more effectively in the future.
  • Flexible Planning: The events are invaluable for resource allocation and capacity planning. For example, "Holiday" or "Sick Leave" events accurately reflect a reduction in a user's capacity. This helps managers to realistically gauge the available workforce and adjust project timelines accordingly. A custom event can be used as a "Placeholder" to test different planning scenarios without immediately impacting Jira issues.
  • Improved Reporting and Timesheets: Custom events can be easily scheduled on the timeline. Their associated time can then be included in various reports and timesheets, providing a comprehensive view of all activities. For example, past booking events can be configured to be treated as worklogs for reporting. ActivityTimeline can also automatically treat external calendar events as worklogs or allow users to manually log time against them. Furthermore, custom fields can be associated with event types to capture additional, specific details, enhancing data granularity.
  • Streamlined Processes: By precisely defining event types to match internal processes, organizations ensure that all work activities are captured. This contributes to a holistic and accurate overview of project timelines and team availability, leading to more efficient management. This helps companies achieve more with fewer surprises, leading to a better customer experience.

Real-Life Case: Optimizing Project Planning

Imagine a company with many employers facing a similar issue: a significant amount of employee time is spent on essential but non-project tasks. These include new hire onboarding, monthly team meetings, and strategic training sessions.

By creating Jira custom events for "Training" and "Onboarding," a manager can visually represent these activities on the team's timeline. The manager can then easily see how these commitments affect each person's capacity for project-related tasks. The data can be used in a report to show that a certain team needs more resources to offset time spent on training, leading to better resource allocation and overall efficiency.

This proactive approach to planning and managing all work activities helps a team stay on track and meet its deadlines. It turns what might need manual tracking in a spreadsheet into an automated, transparent process.

Conclusion

ActivityTimeline's custom events feature gives teams total control over their planning and reporting, allowing them to accurately track all work activities, not just those within Jira. This customization enables more accurate analytics and more informed decisions, making it an essential tool for any organization that values visibility and efficiency.

{{rich-cta-3}}

Ready to gain deeper insights into your team's workload?

Explore how ActivityTimeline's flexible planning can empower your team today.

ActivityTimeline Illustration

Stop guessing and start planning with confidence.

Discover the power of smarter resource allocation.

ActivityTimeline Illustration
Join 2500+ people getting bi-monthly newsletter:
Event and webinar invitations
Project management tips
<0.3% unsubscribe
Free, forever
Thank you! 🙏🏻
Your submission has been received!
Oops! Something went wrong while submitting the form.

Frequently Asked Questions

Can I create an event for a specific user or an entire team?

Yes, when you create an event, you can select either a specific user or the entire team. You can even add a recurrence, for example, to schedule a weekly meeting for the team.

Can I create my own notification scheme?

Yes. To create a new notification scheme, you'll have to go to Jira's configuration. Go to Jira Settings and find the Issues section. Click on the Notification Schemes tab and click "Add". Give the notification scheme's name and press Add. You will be redirected to the new notification scheme page. Here you will be able to add new event notifications.

How do I send an email based on a custom event?

First, you will need to tie the event to a workflow transition. Then, you'll add a post function to the transition's post function, where you can fire the custom event. Finally, you can configure the notification scheme to send an email when the custom event is fired.

How do I fire the custom event?

You can set a post function to fire a generic event or a specific event when the workflow transition is complete. You can also trigger an issue created event. This is especially useful for teams that need to automatically trigger actions when a new event is created.

What is a post function in Jira?

A post function is a powerful feature that automatically performs an action after a workflow transition is executed. For example, a post function can automatically assign an issue to a person, or set the due date when a task moves from "To Do" to "In Progress".

Still have questions about ActivityTimeline? Get in touch
Your most organized Jira workflow is just a click away
Start your 30-day free trial. No credit card required.
Planer | ActivityTimeline