Migrate from Swagger UI for Confluence
Move Confluence pages from Tech Labs' Swagger UI for Confluence, a Connect app, to Apifolio: import the spec and its Swagger UI display options in the Apifolio dialog.
Swagger UI for Confluence by Tech Labs embeds Swagger UI in Confluence pages. In October 2026 it is a Connect app on the Atlassian Marketplace, and Atlassian ends support for Connect apps on 31 January 2027. Apifolio is a Swagger UI alternative built on Forge that runs on Atlassian, with a classic layout that keeps the Swagger UI look.
What the import does
The Apifolio dialog recognises the app's swagger-ui macro.
| In the old macro | In Apifolio |
|---|---|
| A spec pasted into the macro | Checked, attached to the page as a file named after the API title, and selected |
| A file attached to a Confluence page | Selected, on this page or under Another page |
| A link to the spec | Not downloaded: the dialog shows the link, you download the file and click Attach the file |
| Credentials (tokens, keys, passwords, headers) | Never copied. The dialog names them so you can rotate them |
Swagger UI settings such as docExpansion, filter, defaultModelsExpandDepth and defaultModelExpandDepth |
Mapped as in the full table; the dialog lists the ones without an equivalent |
The Classic (Swagger style) layout is preselected: collapsible sections with coloured endpoint bars, as in Swagger UI. You can switch to the modern three-pane layout in the same dialog.
Steps
- Edit a page that uses the old macro and type
/apifolio. - In "Found 1 Open API (Swagger) macro on this page", click Import, Use this file or Attach the file.
- Check the preview and the display options, then click Save.
- Delete the old macro by hand and publish the page.
- If the old macro held credentials, revoke them: they remain in the page history.
Details: Moving from another app.
What changes for readers
- Try it out is replaced by Edit request: readers fill in parameters, the body and credentials, and copy a ready-to-run request in one of 17 languages. Nothing is sent from Confluence. PowerShell and cURL for the Windows command prompt can be added to the default tabs under Code languages.
- A spec that came from a link is now a page attachment. Keep it up to date from your CI: see Keep the docs in sync.
- New: a navigation tree and search that understands pasted URLs and typos, PDF and Word exports with the full reference, Copy for AI and the Rovo agent.
See What Apifolio does not do, and why.
Swagger UI for Confluence is a product of Tech Labs. Apifolio is an independent product, not affiliated with or endorsed by its vendor.