> ## Documentation Index
> Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hierarchy.description

<span id="atoti.Hierarchy.description" />

> *property* Hierarchy.description: [str](https://docs.python.org/3/library/stdtypes.html#str)

Description of the hierarchy.

It is displayed in Atoti UI when hovering the corresponding node in the **Data model** tree to help users understand its purpose.

```pycon theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
>>> df = pd.DataFrame(
...     columns=["Product", "Price"],
...     data=[
...         ("phone", 560),
...         ("headset", 80),
...         ("watch", 250),
...     ],
... )
>>> table = session.read_pandas(df, keys={"Product"}, table_name="Example")
>>> cube = session.create_cube(table)
>>> h = cube.hierarchies
```

Empty by default:

```pycon theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
>>> h["Product"].description
''
```

Changing the description:

```pycon theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
>>> h["Product"].description = "The name of the product"
>>> h["Product"].description
'The name of the product'
```

Blank descriptions are normalized to an empty string:

```pycon theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
>>> h["Product"].description = " "  # Blank description
>>> h["Product"].description
''
```