The Adaptavist Group LogoDocumentation

Egress Control

Egress controls let admins approve additional domains for Mosaic to load content from. This can include your company's internal tools, dashboards, and other trusted sources.

Some Mosaic features load content from external websites. If the source domain isn't approved, that content may not load.

You may need to approve a domain if:

  • Content displays directly on a Confluence page but doesn't load inside a Mosaic macro.
  • Embedded videos don't display correctly, including in full screen mode.
  • Embedded links to Jira Data Center don't display after you migrate Confluence to Cloud.

For example, use CME to approve a domain for your company's knowledge base, video hosting service, or internal dashboard.

Approve a Domain

You must be an orgnaisation admin to add or remove domains.
  1. Click the cog icon to take you to the Administrator Setting page.
  2. Click Mosaic Egress Controls.
  3. Click Add domain group.
  4. Enter a Group description. This identifies the group of domains during approval.
  5. Enter the domain and the appropriate Egress Types.
    Tip: Each egress type chosen uses a domain slot. So selecting two egress types for one domain will use two slots.
  6. Click Add.
  7. Repeat steps 5 & 6 for and additional domains in the same group.
  8. Click Approve pending domains.
  9. Review the entered details, then click Approve.
The entries display an approved status and the aviliable slot count updates.

Accepted domain formats

You can enter domains using the following formats

FormatExample
HTTPS URLhttps://example.com
Subdomaincdn.example.com
Wildcard*.example.com

Remove a single approval

Romove a specific approval for a single egress type and domain. Other egress types for the same domain will remain. Other domains in the group will remain.
  1. Open Mosaic Egress Controls
  2. Find the row for the domain and egress type.
  3. Click Remove.
  4. Review the warning and select Yes, remove.

Delete a domain group

Delete all the approvals in a group at once.
  1. Navigate to Mosaic Egress Controls.
  2. Find the group.
  3. Click Delete group.
  4. Review the warning and confirm the deletion.

Domain limits

You can create up to 10 groups, with up to 10 unique domains per group.

Mosaic and your organisation share an allowance of 40 egress slots. Each domain and egress type combination uses one slot. For example, approving a domain for both Images and Media uses two slots.

Some slots are reserved for Mosaic functionality. Check Available slots to see how many remain.

If a Mosaic update takes the total above 40, existing approvals can exceed the allowance. You cannot add another approval until there is capacity within the 40-slot limit.

Note:

Uninstalling Mosaic removes all groups and domains. Reinstalling Mosaic does not automatically restore them.

Troubleshooting

If content still doesn't load after approval:

  1. Check that the approved domain matches the source of the content. For example, content may load from cdn.example.comrather than example.com. A wildcard such as *.example.com can cover subdomains.

  2. Check that the domain uses a supported format.

  3. If the issue continues, contact support and include:

    • The Mosaic macro containing the content.

    • The domains you added in to egress management.

    • The URL of the content that isn't loading.

    • A screenshot of the issue.

    Mosaic egress management uses Atlassian's domain approval mechanism. Some issues may require investigation by Atlassian

Search documentation

Start typing to search the docs.