> ## Documentation Index
> Fetch the complete documentation index at: https://docs.logictwelve.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions about Better Swagger UI for Confluence

> [accordion] Does this work with Confluence Data Center, or Cloud only?
>
> Cloud only. The app is built on Atlassian's Forge platform, which doesn't support Data Center.

> [accordion] Which OpenAPI/Swagger versions are supported?
>
> OpenAPI 2.0 (Swagger) and 3.0, via the underlying Swagger UI renderer.

> [accordion] Does the macro update automatically when the spec changes?
>
> Yes, if it's configured with a URL — it's fetched live on every page view. If you pasted the document directly as **Content**, it's a static snapshot and only updates when you edit the macro and paste in the new version.

> [accordion] Can I pre-fill credentials for Try it out requests?
>
> Yes. Set **Authorization** to **Basic** to provide a login and password, or **Api Key** to provide a key. Swagger UI applies them automatically when the page loads, so viewers don't need to authorize manually.

> [accordion] The macro shows a warning instead of rendering — what should I check first?
>
> There are two distinct warnings. A **license warning** means the site doesn't have an active license or trial. A **configuration warning** means the macro doesn't have a usable OpenAPI document yet — check that **URL** or **Content** is filled in for the selected **OpenAPI document type**. If it looks configured correctly but still won't load, confirm the spec's URL is reachable over plain `http://` or `https://` — Forge apps can only reach an allow-listed set of domains, and while most common top-level domains (`.com`, `.io`, `.dev`, `.app`, and similar) are covered, some country-code domains aren't, so a spec hosted on one of those will fail to fetch.

> [!TIP]
>
> Can't find what you're looking for? Visit the [Better Swagger UI for Confluence service desk portal](https://logictwelve.atlassian.net/servicedesk/customer/portal/4).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.