> ## 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.

# Get started

> Get up and running with Better Swagger UI for Confluence

Better Swagger UI for Confluence is a Forge app with a single **Better Swagger UI** macro that renders an OpenAPI or Swagger document as an interactive Swagger UI panel — endpoint list, schemas, and a **Try it out** console — directly inside a Confluence page.

## Who this is for

API teams who maintain an OpenAPI 2.0 (Swagger) or 3.0 document and want the familiar Swagger UI reference, including the **Try it out** console, embedded in Confluence instead of linking out to another tool.

## Prerequisites

* A Confluence Cloud site where you can install marketplace apps (this app runs on Forge, which doesn't support Data Center)
* An OpenAPI 2.0 or 3.0 document, as a URL or pasted JSON/YAML
* Optionally, credentials to pre-authorize **Try it out** requests (Basic auth or an API key)

## Get started

<Steps>
  <Step title="Install">
    See [Installation](/swagger-ui-confluence/installation) for how to add Better Swagger UI for Confluence from the Atlassian Marketplace.
  </Step>

  <Step title="Add it to a page">
    See [Usage](/swagger-ui-confluence/usage) for how to insert and set up the macro.
  </Step>

  <Step title="Configure">
    See [Configuration](/swagger-ui-confluence/configuration) for the full reference of every field.
  </Step>
</Steps>

<Tip>
  Need help? Visit the [Better Swagger UI for Confluence service desk portal](https://logictwelve.atlassian.net/servicedesk/customer/portal/4).
</Tip>