Description
Description
The Description is where you add detail and context to an object.
If the Name is what something is called, the Description is where you explain what it is, what it’s for, and what should happen next.
Why it matters
The description is the best place to put anything you want the platform to understand.
The more clearly you describe something, the better the system can support you. This includes recommendations, suggestions, and guided workflows.
The system doesn’t just look at the description of the object itself. It can also use the descriptions of the folders the object sits within.
This means you can define shared context once and reuse it across multiple objects.
How it works
You can edit the description in the Resource Viewer.
Changes are saved automatically when you click away from the field.
When you update the description, the platform may generate attribute recommendations. These appear as suggestion bubbles next to fields, which you can apply or ignore.
What to include
A good description gives enough context for someone else — or the system — to understand what’s going on.
What you write depends on what you’re describing.
If you’re describing a single object, focus on the object itself:
- What this is
- What you’re trying to achieve
- Any important details or constraints
- What should happen next
If you’re describing a folder (an object with subobjects), focus on what belongs inside it:
- What type of things this folder contains
- The tone, style, or approach they should follow
- Any shared context or rules
For example, you might have one folder for a luxury real estate brand and another for a fitness brand. Each folder sets the tone and context for everything inside it. Objects created within those folders will follow that context automatically.
The clearer the description, the more useful the output will be.
How to use it well
Think of the description as how you brief the system.
For a single object, you’re explaining that one piece of work.
For a folder, you’re setting shared context for everything inside it.
This allows you to define things once at the folder level, rather than repeating them on every object.
If something feels unclear, or the suggestions aren’t helpful, it’s often because the description needs more detail.
You don’t need to write a lot, just enough to make the situation clear.
Summary
The description is where you give context.
Anything you want the platform to understand should go here. This includes both the object itself and, where useful, the folders it sits within.
Clear descriptions lead to better recommendations and smoother progress.
Read next: Status
Continue to Status.