Does this work with Confluence Data Center, or Cloud only?
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.
Which OpenAPI/Swagger versions are supported?
Which OpenAPI/Swagger versions are supported?
OpenAPI 2.0 (Swagger) and 3.0, via the underlying Swagger UI renderer.
Does the macro update automatically when the spec changes?
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.
Can I pre-fill credentials for Try it out requests?
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.
The macro shows a warning instead of rendering — what should I check first?
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.