> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.quely.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Create and collaborate on Diagrams

Create a Diagram inside a Unit when a visual explanation is more useful than text alone.

## Create a Diagram

1. Open the Unit.
2. Open or enable **Diagram**.
3. Create a new Diagram.
4. Add shapes and connections, or provide a Mermaid specification if supported by the current control.
5. Give the Diagram a clear name.
6. Confirm that the latest changes are saved.

A Unit can contain multiple Diagrams.

The Diagram gallery supports creating, renaming, duplicating, moving to a Group, archiving, deleting, and reordering Diagrams.

![Create and collaborate on Diagrams](https://storage.crisp.chat/users/helpdesk/website/-/a/8/4/2/a842a666ac554800/diagrams_9xd8mj.gif)

## Use Orbit

Orbit can read a Diagram and help generate one. Give Orbit a clear purpose, such as mapping a workflow, dependency, or system relationship. Review the output before treating it as accurate.

## Use Diagrams for

* Workflows and processes
* Dependencies and system relationships
* User journeys
* Architecture or data flows
* Shared explanations during planning

## Sync behavior

Quely Diagrams remain in Quely and do not sync back to Jira.

---

## Next steps

**Next:** Review Unit activity and stay current

**Related articles:**

* [Use Orbit inside a Unit](https://quely.crisp.help/en/article/use-orbit-inside-a-unit-19yveiz/)
* [Map dependencies with Relationships](https://quely.crisp.help/en/article/map-dependencies-with-relationships-svzmpd/)