Skip to main content


Home > @backstage/plugin-permission-common > Permission

A permission that can be checked through authorization.

type Permission = BasicPermission | ResourcePermission;
References: [BasicPermission](/docs/reference/plugin-permission-common.basicpermission), [ResourcePermission](/docs/reference/plugin-permission-common.resourcepermission)


Permissions are the "what" part of authorization, the action to be performed. This may be reading an entity from the catalog, executing a software template, or any other action a plugin author may wish to protect.

To evaluate authorization, a permission is paired with a Backstage identity (the "who") and evaluated using an authorization policy.