Guide to merging organizations
Before you start
Who can use this feature
Available on the Organization and Enterprise plans
Only organization admins can request merges
Working with Figma’s support team, you can merge the users, files, projects, teams, and plugins from one Figma organization into another.
During a merge, one organization becomes the parent, and the other the child.
- The parent organization keeps its existing users, content and settings.
- All users and content from the child organization move into the parent organization. At the end of the process, Figma removes the child organization.
What happens during a merge?
- All domains associated with the child organization are added to the parent organization
- Figma automatically prefixes teams from the child organization with the child organization name (for example:
Acme-[team name]) - All users from the child organization keep their existing roles when joining the parent organization, unless they are explicitly restricted in the parent organization
- Organization admins in the child organization become members in the parent organization
- Activity logs from the child organization are not included in the merge and are deleted after the merge is complete
- Shared fonts from the child organization are not included in the merge and will need to be re-added to the parent organization
- Deleted users’ drafts from the child organization are not included in the merge and should be moved to a team beforehand
What happens after a merge is complete?
- The parent organization’s settings will apply, including those for domain capture, SAML, SCIM, public links, and approved plugins.
- Users from the child organization will need to login with the parent organization’s identity provider and will use the parent organization moving forward.
Things to check before requesting a merge
- Will users from the child organization be able to authenticate using the parent organization’s identity provider?
- Will you need to bulk update users’ email addresses as part of this process?
Request a merge
To request a merge, please email admin-support@figma.com with the following:
- Any questions about the merge behavior detailed above
- An organization admin from both organizations copied on the thread
- The URL and name of both organizations and which is the parent organization and child organization
- Will users from the child organization be able to authenticate using the parent organization’s identity provider?
- Will you need to bulk update users’ email addresses as part of this process?
Please note we need approval from organization admins at both organizations to start a merge.
Tip: Here’s how to get the URL of your organization:
- Log in to your organization in a web browser.
- From the file browser, click All teams or All workspaces.
- Copy the entire URL in your browser address bar.
