# Source: https://stately.ai/docs/descriptions.mdx

# Descriptions (/docs/descriptions)
import { AlignLeft, Info, Plus } from 'lucide-react';

You can add descriptions to state and event nodes to describe their purpose and share related notes with your team. Descriptions support markdown formatting, including links and images.

You can only add one description for each state or event. The machine object will include your descriptions in the state or eventâs `description` when you export your statecharts to JSON.

<EmbedMachine name="Video player" embedURL="https://stately.ai/registry/editor/embed/e13bef2b-bb13-4465-96ac-0bc25340688e?machineId=574ede8a-a328-40fe-a4f9-c80fffb2c30a" />

In the video player above, the text âThe video player should be in full-screen modeâ is a description of theÂ *Opened*Â event.

## Add a description to a state, event, or transition

Use the <Plus size={18} /> plus icon button and choose <AlignLeft size={18} /> **Description** from the menu to add a description block to your selected state, event, or transition.

You can also add descriptions from the <Info size={18} /> **Details** panel in the right tool menu.

## Delete a description from a state, event, or transition

Select the state, event, or transition whose description you want to delete, open the <Info size={18} /> **Details** panel, and delete the contents of the description text area.