# Word Cloud

Renders a word cloud (tag cloud).

| <picture><source srcset="/files/u84OhtjMY6kxPVHdLjDp" media="(prefers-color-scheme: dark)"><img src="/files/GmYFlEMXqg0WyemJs4Gy" alt="Word Cloud"></picture> |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- |

## Specification

### Aggregation

In word clouds, values (metrics) are [aggregated per word (dimension)](/data-exploration/chart/chart-common.md#dimension-metric) and displayed.

| Item  | Role      | Notes                                       |
| ----- | --------- | ------------------------------------------- |
| Word  | Dimension | Each word in the word cloud                 |
| Value | Metric    | Value that determines the size of each word |

#### Usage example

* Display content tags in a word cloud
  * Word (dimension): Tag name
  * Value (metric): Number of content items with the tag

## Tips

### When not all words are displayed

Word clouds draw words in order of value (largest first), and **words that do not fit in the display area are automatically hidden**. Therefore, words with smaller values may not be shown.

If you have many words and not all of them are visible, try adjusting the "Font size range" or "Word spacing", or resizing the chart area.

Enabling "Auto-shrink to fit" will automatically adjust the font size of words that do not fit in the display area. However, with many words, font size recalculation can make the chart sluggish. For this reason, this option is disabled by default. When enabling it, be mindful of the number of words.

### Frame Feature

Word cloud supports the frame feature. See [Frame Feature](/data-exploration/chart/chart-common.md#frame-feature) for details.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.codatum.com/data-exploration/chart/word-cloud.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.