/
Word Cloud Macro - User Guide

Word Cloud Macro - User Guide

 

Quick Start

Adding Word Cloud to Your Page

  1. Open your Confluence page in edit mode

  2. Type /word cloud to trigger the macro selector

  3. Select "Word Cloud" from the dropdown menu

image-20260130-075958.png

 

  1. Click "Generate Wordcloud" to analyze the current page

  2. Customize appearance using the left panel settings

  3. Click "Save" to insert the word cloud into your page

image-20260130-080018.png

 

Your First Word Cloud

Once generated, the word cloud will visualize the most frequently used words from your page content:

image-20260130-080030.png

 

The word size represents frequency - larger words appear more often in your content.

Interface Overview

Configuration Panel (Left Side)

The left panel contains all customization options organized into sections:

  • Appearance - Visual styling (size, colors, rotation, spacing)

  • Content Options - Data processing (stopwords, subpages)

  • Interaction - User interaction features (search, export)

Live Preview (Right Side)

The right panel shows a real-time preview of your word cloud:

  • Generate Wordcloud - Creates/updates the visualization

  • Export - Download as PNG, SVG, or CSV

  • Refresh - Reload with current settings

image-20260130-080100.png

 

Features

1. Intelligent Text Analysis

The plugin automatically:

  • ✅ Extracts text from headings, paragraphs, lists, and tables

  • ✅ Excludes code blocks, @mentions, and links

  • ✅ Filters common stopwords (English, German, Spanish, French, Italian)

  • ✅ Counts word frequency using fair counting (no artificial weights)

2. Subpage Analysis

image-20260130-080143.png

 

Enable "Include subpages" to create a comprehensive word cloud from:

  • Current page content

  • All child pages recursively

  • Perfect for analyzing entire documentation sections

3. Interactive Word Search

image-20260130-080200.png

 

Enable "Enable clickable word search" to:

  • Click any word in the visualization

  • Automatically search for that term in Confluence

  • Quickly find related content in your space

4. Export Functionality

image-20260130-080212.png

 

Export your word cloud in multiple formats:

Format

Use Case

Features

Format

Use Case

Features

PNG

Presentations, reports

High-resolution raster image (4x scale)

SVG

Print, scalable graphics

Vector format, infinite scaling

CSV

Data analysis

Raw word frequency data

5. View Mode

image-20260130-080230.png

 

Once saved, the word cloud appears beautifully integrated into your Confluence page. Readers can:

  • View the visualization instantly

  • Interact with words (if enabled)

  • Export the visualization (if enabled)

Default Configuration

Setting

Default Value

Setting

Default Value

Size

Medium (600×450)

Color Theme

Default (blue gradient)

Word Rotation

Horizontal Only

Maximum Words

50

Word Spacing

4

Font Family

System Default

Filter Stopwords

Enabled ✓

Include Subpages

Disabled ✗

Clickable Word Search

Disabled ✗

Show Export Button

Disabled ✗