# Word Cloud

Renders a word cloud (tag cloud).

| <picture><source srcset="https://1875572357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzP7hFWzU2Jj7xMbv2nyp%2Fuploads%2Fgit-blob-0aa0b3d6b5856bc7fe938c6e269bb7834ebbd073%2Fword-cloud-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://1875572357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzP7hFWzU2Jj7xMbv2nyp%2Fuploads%2Fgit-blob-e68e29d988819d46a845db8fd3e0ebb0da4688b9%2Fword-cloud-light.png?alt=media" alt="Word Cloud"></picture> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

## Specification

### Aggregation

In word clouds, values (metrics) are [aggregated per word (dimension)](https://docs.codatum.com/data-exploration/chart-common#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](https://docs.codatum.com/data-exploration/chart-common#frame-feature) for details.