Note Component
The Note component lets you add annotations, instructions, and documentation directly onto your Studio Canvas. Notes don’t connect to other components. Instead, they make your workflows easier to understand and maintain, especially when collaborating with others.
Why Notes Matter
When to Use Notes
You’ll find Notes most helpful when you want to:
- Explain complex logic next to a Code or Loop component.
- Leave collaboration cues for teammates, like “Connect to production database” or “Don’t change this API key.”
- Visually organize sections of your workflow (for example, “Step 1: Data Ingestion,” “Step 2: Processing,” “Step 3: Outputs”).
- Document context for future you, so you remember why you designed something a certain way.
Configure Notes
You configure Notes directly from the settings panel. Notes have no functional inputs or outputs and they are purely for documentation.
Formatting Mode
Notes support two formatting modes:
Mode | Description |
---|---|
Plain Text | Simple comments without styling. |
Markdown (with MDX support) | Add headings, lists, or even JSX-style MDX components. |
Markdown Note Example
## H2 Header
- Bullet point one
- Bullet point two
<MyComponent title="Custom Title">
This is JSX-style content inside MDX.
</MyComponent>
Appearance
Setting | Description |
---|---|
Title | The note’s header. Edit it directly on the block in the canvas by hovering and clicking the pencil icon. |
Content | The body of your note. Write plain text, or use Markdown/MDX if formatting is enabled. |
Text Color | Choose a color for your text. |
Background Color | Choose a color for the card background. |
Color Coding Notes
Best Practices
- Document logic near complexity: Place Notes next to advanced components to explain what they do.
- Use Notes for team workflows: Write clear TODOs or warnings where teammates might otherwise be confused.
- Structure the canvas visually: Add Notes as headers to break your workflow into steps.
- Keep them readable: Always use text and background colors with enough contrast.
Troubleshooting Notes
Common Issues
What to Try Next
- Add a Note beside an API Call to document the endpoint’s purpose.
- Use Notes to storyboard your workflow before connecting components in the Studio Canvas.
- Create a “legend” at the top of your workflow explaining your color-coding system.
- Explore Collaboration features to see how Notes help teams work more smoothly.