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

# Add context with a document description

> Add descriptions to Sigma workbooks, reports, and data models to document contents, status, quality, and reliability.

Add a description to a workbook, report, or data model to provide context about the document's contents, status, quality, and reliability. For example, if you have a data app to manage project tasks for a website redesign, add a description like "Track project status, assignees, and deliverables for the website redesign initiative".

You can also set a badge on a document to reflect its status and reliability. For information about setting badges, see [View and manage document badges](/docs/view-and-manage-document-badges).

Sigma Assistant and other AI functionality in Sigma use descriptions and badges as contextual metadata when [selecting data sources from the configured sources](/docs/configure-ai-features-for-your-organization#how-ask-sigma-selects-data-sources-when-answering-user-questions). For more details, see [Data modeling best practices](/docs/data-modeling-best-practices).

For details about adding contextual metadata to data sources:

* To add descriptions to data models, see [Create and manage data models](/docs/create-and-manage-data-models#edit-a-data-model-description).
* To add descriptions and badges to tables from your data platform, see [Review and manage your data catalog](/docs/manage-data-catalog).

If you want to manage the contents of a document according to stages of development, use version tagging instead. See [About version tags to workbooks, data models, and reports](/docs/add-version-tags-to-workbooks-and-data-models).

## User requirements

* To add or delete a document description, you must have **Can edit** access to the document.
* Descriptions are visible to any user with access to the document.

## Add a description to a document

1. Open a document.
2. Select the document name to open the document menu, then select **About this workbook** for a workbook, or **About this report** for a report.
3. In the text box below the document name, type a description. The description saves automatically.
4. Click **Close** (**X**) or click outside the modal to return to your document.

## View a document description

The document description is visible when viewing the document, or when previewing details about the document by hovering over the document in a workspace or folder.

To view a document description from the document:

1. Open a workbook or report.
2. Hover over the title to view the description. If the document has a badge set, the badge details are also visible.

## Delete a document description

1. Select the workbook name to open the document menu, then select **About this workbook**, or **About this report** for a report.
2. In the text box below the document name, remove the description. The change saves automatically.
3. Click the **X** or click outside the modal to return to your document.

## Related resources

* [View and manage document badges](/docs/view-and-manage-document-badges)
* [Create and manage data models](/docs/create-and-manage-data-models)
* [Review and manage your data catalog](/docs/manage-data-catalog)