Migrate SCIM seats to the updated billing model

If you've previously managed seats for your organization with SCIM and want to continue doing so, you may need to take some steps to ensure your SCIM user configuration works correctly with the updated billing model.

Old method of user configuration

Previously, when you used SCIM to explicitly assign users seats in Figma, you would set the following permissions:

• figmaPermission
• devModePermission
• figjamPermission

While best practice was to assign values to each of the attributes, it wasn't required. You could exclude unused permissions, or set the value of a permission to null.

Now, so Figma can correctly map your SCIM configuration to the seat types in the updated billing model, you need to do one of the following:

• Configure SCIM so your users can be assigned to the new seat types: Full, Dev, Collab, and View. This is the recommended method.
• Modify your existing SCIM configuration so Figma can correctly map users to the updated seat types. This method will only work until March 2026, at which point you need to ensure your users are directly assigned to the new seat types.
• Work with Figma support to continue using your existing SCIM user configuration. This is the least advisable method. If you don't modify your configuration and if you've used the Figma interface to assign any licenses outside of your SCIM integration, those assignments will be revoked. Additionally, like the previous method, this will only work until March 2026.

Use the new seat types (best practice)

The best way to ensure you can continue to manage your SCIM users as normal, including upgrading and downgrading, is to migrate to the new seat types. See Manage Seats via SCIM for information about how to update your SCIM configuration to handle the new seat types.

Modify your existing configuration

To continue managing users with your existing SCIM configuration, such as being able to downgrade users, you need to make two updates:

1. Ensure that all users have the following three permissions: figmaPermission, devModePermission, and figjamPermission.
2. Ensure that each permission is set to one of the following values: full or viewerRestricted.

When your SCIM users are configured in this way, it will ensure that Figma is able to correctly map the users to the new seat types. However, this method will no longer work after March 2026.

If you're not able to update your user configuration to meet these requirements, you should work with Figma support.

Work with Figma support

If you're not able to modify your existing SCIM configuration, or if there is a reason you need to maintain a setup that applies only a limited set of the product permissions, Figma support can help you temporarily enable your configuration. However, there are some risks:

• Any users that you assigned products to via the Figma, not using SCIM, will have their assignments reset to whatever is configured via SCIM. This means those users will lose access to Figma products until they are assigned again via SCIM.
• Any SCIM users that do not have a permission for a given product (for example, if figjamPermission is not included) or where the permission has a null value (for example, if figjamPermission is set to null) will lose access to the corresponding Figma products until they are assigned again.

If you use this method, users are mapped to the new seat types based on a hierarchy of the products that they have full access to. For example, a user with only a figjamPermission: full permission would be mapped to a Collab seat. As another example, a user with devModePermission: full and figjamPermission: viewerRestricted would be mapped to a Dev seat, as devModePermission takes precedence in terms of mapping. If all permissions are set to viewerRestricted then the View seat is used.

The exact order of precedence is figmaPermission > devModePermission > figjamPermission.

Additionally, like the previous method, you'll only be able to use this configuration until March 2026. At that point, your SCIM configuration must be updated to handle the new seat types.

To contact Figma support, reach out to your account manager, or follow the steps in Get help with Figma.