Developer
News and Updates
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Display conditions
Permissions
Translations
Last updated Jan 29, 2026

Permissions

You can control when a module is shown based on its permission state. Use this feature on modules that support displayConditions.permissions.

What it does

Permission-based display conditions let you show a module only when specific permissions are in effect. Each condition maps to a corresponding section in the Permissions manifest reference.

TypeDescription
scopesShows the module only when the app has (or the user is in a context that implies) certain OAuth scopes.
external.fetch.backendShows the module only when the specified egress addresses are allowed (e.g. *.example.com, or an object with address).
external.fetch.clientShows the module only when the specified egress addresses are allowed (e.g. *.example.com, or an object with address).
external.fontsShows the module only when the specified font sources are allowed.
external.imagesShows the module only when the specified image sources are allowed.
external.scriptsShows the module only when the specified script sources are allowed.
external.stylesShows the module only when the specified style sources are allowed.
external.framesShows the module only when the specified frame sources are allowed.
external.mediaShows the module only when the specified media sources are allowed.

Values can be a string (for a single scope or address) or an array (for multiple values). For backend and client, you can also use an object with an address property, matching the manifest permissions format.

Example

In the example below, two Jira issue panel modules use permission-based display conditions: one for a scope, and one for external fetch (backend and client).

1
2
modules:
  jira:issuePanel:
    - key: panel-with-scope
      title: Panel with scope condition
      function: panel-func
      displayConditions:
        permissions:
          scopes: "read:jira-work"
    - key: panel-with-fetch-backend
      title: Panel with fetch backend condition
      function: panel-func
      displayConditions:
        permissions:
          external:
            fetch:
              backend: "*.example.com"
              client: "https://client.example.com"

More information

Rate this page: