> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://help.sigmacomputing.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server.

# Create and edit reports

Reports are a Sigma document type designed to help you create predictable, pixel-perfect PDF exports. Precisely formatted exports are helpful for a variety of enterprise reporting needs, such as compliance, external reporting, and embedded analytics. For more information about reports, see [Reports overview](/docs/reports-overview).

Creating a report in Sigma allows you to [add](/docs/add-elements-and-data-to-a-report) and [arrange elements](/docs/customize-element-size-position-and-layering), manage your report [page setup](/docs/edit-report-page-setup-headers-and-footers) and [page order, visibility, and numbers](/docs/edit-report-page-order-visibility-and-numbers), [customize your report branding](/docs/customize-report-elements-settings-and-branding), [export reports](/docs/share-and-export-reports), and more.

## User requirements

* To create a report, you must be assigned an [account type](/docs/account-type-and-license-overview) with **Create, edit, and publish reports** permission. See [Account type and license overview](/docs/account-type-and-license-overview).

## Considerations when creating reports versus workbooks

Reports allow you to customize element formatting and positioning at the pixel level. When building reports, exports are always reliably formatted, helping you fully meet compliance and branding needs. If you have a clear idea of the type of analysis you want to do, and need to export your analysis for external consumers, a report is likely suitable for your needs.

However, some workbook functionality is not available in reports:

* Configuring [interactivity and actions](/docs/intro-to-actions) is not supported.
* Using [custom views](/docs/create-and-interact-with-custom-views) for ad hoc exploration is not supported.

If you want to use this functionality, and have more exploratory or heavily analytical needs that don't require precisely formatted exports, a workbook is likely more suitable.

## Create a report

You can create a report from **Home** or from an existing report:

### Create a report from the Sigma home page

1. From **Home**, select <img src="https://sigma-doc-screenshots.s3.us-west-2.amazonaws.com/Icons/button-add.svg" alt="" /> **Create New**, then select **Report**. A new draft report is created.
2. After making your changes, select **Publish**.

Once you have created a report, you can search for it via <img src="https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/search.svg" alt="" /> **Search**. You can search for both draft and published reports. Unlike workbooks, there is no concept of “explorations” in reports, so unsaved reports will not appear in the **Explorations** tab of the **Recents** page.

### Create a report from an existing report

1. From an existing report, open the document menu.
2. Select **File**, then **Save** as a new report.
3. Enter a **Name** for the report, then select **Save**.

## Edit and publish a report

### Edit a report

To make changes to a report, select **Edit** in the report header.

Once you are in **Edit** mode, the **Add element** bar, toolbar, editor panel, page previews, and other functionality become available to use. Changes you make to a report draft automatically save to the live draft shared by all users who can edit the report.

### Publish a report

To publish your edits, select **Publish** in the report header. This action publishes all drafted changes to the report, including changes made by other editors using the live draft.

When viewing the published version of a report, all users who are able to view and edit the report are able to update control values. This is the only interactivity available on a published report. Unlike when viewing a workbook, they are not able to make any other changes to the report, like updating filters, refreshing data, or creating custom and saved views.

## Related resources

* [Tutorial: Build and export a sales report](/docs/tutorial-build-and-export-a-sales-report)
* [Add elements and data to a report](/docs/add-elements-and-data-to-a-report)
* [Edit report page order, visibility, and numbers](/docs/edit-report-page-order-visibility-and-numbers)
* [Customize report settings and themes](/docs/customize-report-elements-settings-and-branding)
* [Share and export reports](/docs/share-and-export-reports)
* [Customize text typeface, size, and style in reports](/docs/customize-text-typeface-size-and-style)
* [Customize element size, position, and layering](/docs/customize-element-size-position-and-layering)