Skip to main content

Fresh Look: The New Jira Sync Experience

Sync projects, tasks, users and more with our new enhanced Jira integration!

Stephan avatar
Written by Stephan
Updated over a month ago

Plans ๐Ÿ’ณ : Premium, Unlimited, Unlimited+

User Permissions ๐Ÿ‘ฅ: Employees*, Managers*, Admins

Optional Add-ons: Tasks*


Overview

If your team works in Jira but tracks time in Timely, this integration is here to save your sanity.

Instead of bouncing between tools or duplicating work, the Jira sync integration pipes key data straight into Timely - so your timeline stays accurate, your projects stay organized, and your team doesnโ€™t have to lift a finger (well, maybe just few).

Once connected, Jira projects, tasks, users, and more flow into Timely automatically. Tasks show up as Memories on your timeline, so logging time against actual work is a breeze. You can also map tasks to the right clients and teams, keeping your timesheets clean, tidy, and ready to report on.

Whether youโ€™re juggling client deliverables, managing multiple teams, or just trying to keep your tools in sync, this integration is designed to simplify your workflow - not complicate it.


Table of Contents


๐Ÿ› ๏ธ What does it sync?

  • Projects โ€“ Automatically imported from Jira.

  • Clients โ€“ Jira workspaces become Timely clients (fallback client configurable).

  • Users โ€“ Imported only if they authenticate via Timely and/or have public email visibility configured in their Atlassian profile.

  • Tags and Teams โ€“ Coming soon!

  • Tasks as Memories โ€“ Work done on Jira tasks shows up on your Timely timeline, linked and attached to your time entries.


๐Ÿ”Œ How to connect Jira to Timely - Workspace Admin

Connecting your organizationโ€™s Jira instance to Timely is quick and easy - but there are two parts to this integration:

  • A workspace-wide connection (set up by an admin)

  • An individual user connection (after the admin setup is complete)

Letโ€™s walk through the admin setup first:

  1. Log into your Timely workspace and navigate to the Settings > Ecosystem area

  2. In the Next-Gen Integrations category you'll see the new enhanced Jira connector

  3. After clicking the Jira option click the "Connect workspace with Jira" button

  4. If not already logged in, you'll be asked to enter in your Atlassian credentials

  5. Next, you'll be prompted to approve the necessary permissions that allow data to flow between your Jira instance and Timely

    1. You'll see the option to select which Jira instance to connect to Timely, if you have more than one

    2. Once selected, scroll down to the very bottom and click the "Accept" button to proceed

  6. ๐Ÿ›‘ STOP! Once your Jira instance has been successfully connected you'll be prompted with a screen titled "What Jira data are you interested in?" - make sure that the toggle for the desired Jira instance is ON and click the "configure" button to select or de-select the desired projects for sync.

    1. ๐Ÿ›‘ If you skip this step, all available projects within the Jira instance will sync by default. Click the "Done" button once you've made your selections

  7. If everything looks good so far, go ahead and click the "Next" button to proceed

  8. โš ๏ธ Now you'll be prompted to confirm how Timely will use the data and objects imported from Jira

    1. By default this integration will create projects in Timely based on those projects within Jira

    2. Reference Jira issues when logging time to projects imported

    3. Create clients from Jira organizations

    4. Jira changes will be imported to Timely in "real time"

    5. All admins can access imported data

    6. Additional settings as displayed during setup

  9. To deviate from the defaults, click the "Change Settings" button to customize those options

    1. When prompted select or deselect the objects and data you'd like to keep in sync

    2. Select your fallback option if the client object relationship is unclear from Jira

    3. For more advanced options

      1. Configure if you'd like to enable "real time" updates between Jira and Timely, keeping everything in sync constantly

      2. Restrict imported data to authenticated users

        1. ๐Ÿ›‘ STOP! If this option is disabled, users in workspace will be able to see all imported objects, regardless if they are personally assigned to that project or task

    4. Once configured, click "Ok" to save your selections

    5. If everything looks good and you're ready to proceed, click the "Synchronize with Jira" button to finalize setup

  10. โœ… You're all set! It may take several minutes for the initial sync to take place, you can click the "Continue while import runs in the background" button to return to the Ecosystem tab and work normally while this process completes.

  11. Click the "Complete Jira Setup" button to leave the import menu

๐Ÿ” Need to make a change to your setup? Clicking the Jira integration and then "Manage workspace integration" will allow you to make adjustments. Note that only the original authorizing admin can make those adjustments moving forward.


๐Ÿ”Œ How to connect Jira to Timely - Personal Integration (Employees, Managers)

If you enabled the โ€œRestrict imported data to authenticated usersโ€ option during setup, each user in the workspace will need to connect their own Jira account in order to view or interact with synced Jira objects.

  1. Log into your Timely workspace and navigate to the Settings > Ecosystem area

  2. In the Next-Gen Integrations category you'll see the new enhanced Jira connector

  3. After clicking the Jira option click the "Set up personal integration" button

  4. Click the "Authenticate with Jira" button to proceed

  5. Next, you'll be prompted to approve the necessary permissions that allow data to flow between your Jira profile and Timely

    1. You'll see the option to select which Jira instance to connect to Timely, if you have more than one

    2. Once selected, scroll down to the very bottom and click the "Accept" button to proceed

  6. โœ… You're all set! It may take several minutes for the initial sync to take place, you can click the "Continue while import runs in the background" button to return to the Ecosystem tab and work normally while this process completes.


๐Ÿ“ˆ Your Jira timeline experience

Now that you have Jira connected you can expect to see various updates from Jira right alongside your other memories in Timely. Memories will be created on the timeline of the user who interacts with with a Jira issue - including creating, updating, commenting on and logging time to an issue using Jira's work log feature.
โ€‹
As you select your Jira memories you'll also see that you can choose to associate that work with a specific issue ID imported from Jira. Timely will provide helpful suggestions, you'll just want to make sure you select the appropriate task before finalizing your entry.

โžก๏ธ It's an important step to associate your time entry with a specific Jira task, as this is required to report on the time you spend on Jira issues from Timely, including the export options mentioned in detail below. โ€‹


๐Ÿ“Š Exporting and reporting on Jira time entries

You've logged your hours and now you'd like to deep dive into your data - great! You can leverage the powerful export features in Timely to generate a comprehensive file containing the hours you've logged from Jira. You'll see a new option in the CSV and Excel export menu to create a column with those linked Jira Issue IDs for easy reference:


๐Ÿง  Behind the scenes (for the curious)

Made a change in Jira but not seeing it show up in Timely right away? Some of our sync tasks run quietly in the background on a set schedule - this helps keep your data in sync without overloading Jiraโ€™s APIs. So donโ€™t worry if updates take a little time to appear!

Task

Frequency

Purpose

Sync Webhooks

Hourly

Refreshes webhooks before expiry

Sync Projects

Every 15 mins

Keeps project data fresh

Sync Tasks (legacy)

Daily @ 2am

Backup sync task (not always used)

Sync Identities

Every 6 hours

Brings in newly added users (with public email)


๐Ÿ™‹ FAQs

โ€‹I've logged hours to a Jira task in Timely but don't see those hours reflected in Jira?


Currently, time entries created in Timely donโ€™t sync back to Jiraโ€”itโ€™s a one-way sync from Jira into Timely only.

Do tasks show up on my timeline automatically?


Yep! If youโ€™re working on a Jira task, itโ€™ll appear on your Timely timeline as a memory, ready to log.


Need more help?

Click the chat icon at the bottom of your screen

or send an email to [email protected]

Did this answer your question?