---
title: "Word Cloud"
description: "A visualization that displays words in varying sizes and colors based on a numeric value, commonly used to depict keyword prominence, frequency, or importance within a dataset."
group: Charts
tags: [Visualization, Chart, Dashboard, WordCloud, Text, Frequency, Keyword]
---

import { Aside, Steps } from '@astrojs/starlight/components';

# Word Cloud

The **Word Cloud Chart** visualizes text-based data where each word's size and color represent its corresponding value, typically frequency or importance.  
It arranges words in a dynamic, cloud-like layout and optionally uses images or shapes to mask the word layout.

**Use cases:**
- Displaying **keyword frequencies** from survey responses or articles.
- Highlighting **trending topics** or popular terms from text data.
- Visualizing **relative importance** or volume of categories in a visually engaging way.

<Aside>
Use **Word Cloud Charts** when you need to display **frequencies or weighted text values** in an appealing, informal visual.  
Avoid for precise numeric comparisons or when ranking clarity is essential.
</Aside>

---

## ⚙️ Setup

<Steps>
1. Drag the **Word Cloud Chart** widget from the chart library onto your designer workspace.
2. Select the chart.
3. Go to the [Widget Configuration](/insights-v8/guide-to-infoboard-designer/customize-panel/configure/) tab in the Configuration panel.
4. Under the Configuration panel tab, select the [Basic Configuration](/insights-v8/guide-to-infoboard-designer/customize-panel/configure/#basic) option to access essential settings for the Word Cloud Chart.
5. Select the [Source](/insights-v8/guide-to-infoboard-designer/customize-panel/setup/#sources) from which the chart will fetch its data.
6. Map:
   - **[Measure](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** — Numeric value representing the weight or frequency of each word.
   - **[Dimension](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** — Text or category field containing the words to be displayed.
7. Optionally add a **Date** field for time-based filtering.
</Steps>

---

## 📊 Basic Configuration

| Configuration Item   | Description |
|:---------------------|:-------------|
| **[Source](/insights-v8/guide-to-infoboard-designer/customize-panel/setup/#sources)**        | The data source to query for chart values. |
| **[Measure](/studio-v8/datasources/measures-dimensions-and-hierarchies/)**   | Numeric value used to scale the size of each word. |
| **[Dimension](/studio-v8/datasources/measures-dimensions-and-hierarchies/)**  | The text field whose values are displayed as words in the chart. |
| **Date Field** (optional) | Enables date-based filtering and drilldown capability. |

<Aside type="note">
Use **Measure** to assign importance or frequency to words.  
If no value is mapped, all words will render with equal size.
</Aside>

---

## 🎨 Chart Customizations

| Category                     | Options & Description |
|:----------------------------|:-----------------------------------------------------------|
| **[General](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#general)** | Theme, background, and interactivity options. |
| **[Title](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#title)** | Chart title, font, alignment, and visibility settings. |
| **[Grid](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#grid)** | Adjust padding or spacing around the Word Cloud area. |
| **[Series](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#series-customization)** | Control word colors, size range, font family, and text orientation. |
| **[Tooltip](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#tooltip)** | Tooltip content, format, and triggers for word hover details. |
| **Others** | Configure **Shape** (circle, diamond, star, etc.), **Mask Image**, **Word Size Range**, **Rotation Range**, **Rotation Step**, **Word Gap**, and **Font Family**. |

<Aside>
Use **Mask Image** to shape your Word Cloud into logos or custom figures, and fine-tune **Rotation Range** and **Gap** to enhance readability.
</Aside>

---

## 📊 Example Visualization

![word cloud chart](/images/Insights/Infoboards/Infoboard-Designer/Chart-Library/word-cloud.png)


