ActivityTimeline Help Center
ActivityTimeline Help Center
Breadcrumbs

Refresh Projects

ActivityTimeline synchronizes Jira projects to keep the project list in the application up to date.

By default, the Jira project list is synchronized once a week. ActivityTimeline administrators can also refresh projects manually when needed.

Manual Project Synchronization

Еo manually synchronize Jira projects:

  1. Go to ActivityTimeline Configuration → Synchronization.

  2. Open the Refresh Projects tab.

  3. Click Refresh Projects.

ActivityTimeline will check Jira for project updates and refresh the project list in the application.

This operation may take a few minutes to complete, depending on the number of projects in your Jira instance. For large instances, the process may take around 10–15 minutes.

1-20240919-091115.webp

Project Synchronization Settings

2-20240919-091116.webp

Automatically Refresh Project List

ActivityTimeline allows administrators to control how often the Jira project list is synchronized.

To change the synchronization frequency, go to the Project Settings section in the Refresh Projects tab.

You can select one of the available options from the drop-down list:

  • Weekly — default option. The project list is refreshed once a week.

  • Daily — the project list is refreshed every day.

  • Never — the project list is not refreshed automatically.

Use Never if you do not want ActivityTimeline to automatically update the list of projects from Jira.

Make New Projects Inactive by Default

Administrators can choose how newly imported Jira projects should appear in ActivityTimeline.

If you want newly synchronized Jira projects to be imported as inactive:

  1. Open ActivityTimeline Configuration → Synchronization → Refresh Projects.

  2. Enable Make new projects inactive by default.

  3. Click Save Changes.

After this option is enabled, new projects created in Jira will be imported into ActivityTimeline as inactive. Administrators can activate them later from the project configuration if needed.

This option is useful when your Jira instance contains many projects and you want to control which projects are available for planning and reporting in ActivityTimeline.

Project Is Synchronized, but Issues Are Not Loaded

If the project is enabled and synchronized but no issues are loaded, it’s likely that ActivityTimeline lacks the Browse Project permission.

🔧 How to fix it:

For Data Center:

  1. Go to ActivityTimeline → Configuration → Technical Info and check who is listed as the Sync User.

  1. In Jira → Project Settings → Permissions, verify that the Sync User has the Browse Projects permission for the relevant project.

  • If not, please grant this permission.

  1. Once updated, go to ActivityTimeline → Configuration → Projects and click ‘Sync Tickets’ next to the affected project to trigger a manual sync.

For Cloud:

  1. In Jira → Project Settings → Permissions, ensure that the atlassian-addons-project-access group has the Browse Projects permission.

  1. Once updated, return to ActivityTimeline → Configuration → Projects and click ‘Sync Tickets’ next to the project to trigger a manual sync.


For more information regarding Project Synchronization in ActivityTimeline we recommend checking the following page: Project Synchronisation