# 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](/docs/migration/#display-options-that-carry-over); 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

1. Edit a page that uses the old macro and type `/apifolio`.
2. In "Found 1 Open API (Swagger) macro on this page", click **Import**, **Use this file** or **Attach the file**.
3. Check the preview and the display options, then click **Save**.
4. Delete the old macro by hand and publish the page.
5. If the old macro held credentials, revoke them: they remain in the page history.

Details: [Moving from another app](/docs/migration/).

## What changes for readers

- **Try it out** is replaced by [Edit request](/docs/edit-request/): readers fill in parameters, the body and credentials, and copy a ready-to-run request in one of [17 languages](/docs/code-samples/). 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](/docs/keep-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](/docs/what-apifolio-does-not-do/).

Swagger UI for Confluence is a product of Tech Labs. Apifolio is an independent product, not affiliated with or endorsed by its vendor.
