The migration raises the "missing reference to group - [group_name]" error

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

Check what to do when your Server to Cloud migration raises the error "missing reference to group - [group_name]".

Overview

When running a migration using JCMA, an error such as the one below is seen in the migration logs:

1 2 ERROR ABC project-export Group reference could not be found. Details: Portal Share Page [ABC Dashboard] with id - [10000] has missing reference to group - [group_name].

The problem is caused by a stale group reference on the entity that is being migrated.

The stale reference can be due to either the group being deleted or the external directory where the group comes from being inactive / removed.

This problem is not limited to dashboards but also can be seen for other entities such as filters.

Solution

  1. If the group is deleted, a dummy group with the same name can be recreated. This group does not need to have the same original members.

  2. In cases where the group comes from an external directory, it can be re-enabled. If this is not desired, solution (1) can be used.

Updated on March 3, 2025

Still need help?

The Atlassian Community is here for you.