# Description Text
UI guidelines on descriptions texts.
Description text provides explanatory information about a set of settings or a single item in a list or tree.
{width=715}
## When to Use
Use description text to:
* Show details about items in a list or tree:
{width=665}
* Describe a group of settings:
{width=1012}
## How to Use
### Text
Follow general rules in [Writing short and clear](writing_short.md) and [Punctuation](punctuation.md).
Use the default text style for plain text. Increase line height by 3px from the default value.
Use [H4 bold](typography.md) (Default bold) for headings or to highlight important words:
{width=320}
Use the editor font to highlight code snippets:
{width=283}
Use bullets for lists:
{width=283}
Limit the width of the line to 70–80 symbols, as it is not convenient to read very long lines:
Incorrect
{width=878}
Correct
{width=878}
If the text does not fit, add a scrollbar:
{width=333}
### Appearance
Do not add borders around the description text. Use the panel color for the background.
| Incorrect | Correct |
|-----------------------------------------------------|-----------------------------------------------------|
| {width="302"} | {width="302"} |
For [links](link.md), use the default link color: `Link.activeForeground`. Underline links on hover:
{width=283}
### Insets
Separate the text from the surroundings with insets.
Use a 12px horizontal inset if the description text’s area has other elements:
{width=586}
Increase inset up to 20px if the description text is the only element:
{width=571}