ActivityTimeline regularly checks Jira for user updates and adds new users to ActivityTimeline when they match the configured synchronization rules.
By default, user synchronization runs automatically once a day, usually during the nightly background synchronization.
This process can include newly added Jira users if they belong to the Jira groups configured for synchronization.
Manual User Synchronization
If you need to update the user list sooner, an ActivityTimeline administrator can run user synchronization manually.
To refresh users manually:
-
Go to Configuration → Synchronization.
-
Open the Refresh Users tab.
-
Click Refresh Users.
After the synchronization is completed, you will be redirected to the Users page, where the updated list of users will be displayed.
Default Jira Groups Used for User Synchronization
By default, ActivityTimeline searches for users in the following Jira groups:
jira-software-users
jira-core-users
jira-users
jira-software-users-<INSTANCE_NAME>
Deleted Jira Users
If a user is deleted or deactivated in Jira, they are not automatically removed from ActivityTimeline. Instead, during synchronization, their ActivityTimeline role is changed to No Access to preserve historical data, such as past plans, bookings, and worklogs.
To remove such users manually if necessary:
-
Go to Configuration → Users.
-
Find the required user.
-
Click Manage User.
-
Using Additional Jira Groups
If your organization uses a different Jira group that contains the users you want to synchronize, you can add it to ActivityTimeline.
To do this:
-
Go to Configuration → Synchronization → Refresh Users.
-
Find the Extra groups to search users in field.
-
Add the required Jira group.
-
Save the changes.
-
Click Refresh Users.
ActivityTimeline will then include users from this group during synchronization.
If you’d like to limit user synchronization to specific Jira groups, contact our support team. We’ll help you review your setup and choose the right approach while keeping existing user data in mind.
Additional User Synchronization Settings
Administrators can also configure how often ActivityTimeline should search for new Jira users.
Available options usually include:
-
Daily — new users are checked and synchronized every day.
-
Weekly — new users are checked and synchronized once a week.
-
Never — new users are not added automatically.
You can also define which default ActivityTimeline role should be assigned to newly synchronized users.
This is useful when you want new users to be added automatically but still control their initial access level in ActivityTimeline.
If some users are missing
First, check whether the relevant Jira groups exist and whether the required users are included in those groups.
If users were recently added to a Jira group, go to:
Configuration → Users → Groups → Refresh Groups
Then run Refresh Users again from:
Configuration → Synchronization → Refresh Users
Alternatively, if you have another Jira group that contains all required users, add it to the Extra groups to search users in field in the user synchronization settings, then click Refresh Users.
Atlassian Service Accounts (Cloud — Early Access)
Synchronizing Atlassian Service Accounts with ActivityTimeline is available through our Early Access Program (EAP). To enable this functionality, contact our support team for activation instructions and a step-by-step configuration guide.