Title: Tag Cloud block
Author: khushbu desai
Published: August 17, 2020
Last modified: May 25, 2026

---

# Tag Cloud block

## In this article

 * [How to add a Tag Cloud block to your post or page](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#how-to-add-a-tag-cloud-block-to-your-post-or-page)
 * [Block toolbar ](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#block-toolbar)
    - [Transform to](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#transform-to)
    - [Drag](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#drag)
    - [Move handles](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#move-handles)
    - [Change alignment  ](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#change-alignment)
    - [More options](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#more-options)
 * [Block settings](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#block-settings)
    - [Settings tab](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#settings-tab)
    - [Styles tab](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#styles-tab)
    - [Advanced](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#advanced)
 * [Changelog](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#changelog)

[ Back to top](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#wp--skip-link--target)

[Go back to the list of **Blocks**](https://wordpress.org/documentation/article/blocks/)

The _Tag Cloud block_ allows adding tag/category cloud into the page/post. A tag
cloud is a list of all [tags](https://wordpress.org/documentation/article/posts-tags-screen/)/
categories on your site, displayed in alphabetical order.  

Tag cloud helps your readers to discover and search content easily and quickly.

The _Tag Cloud block_ displays each tag with the font size based on the number of
times that tag has been associated with posts. The bigger the size, the more posts
are tagged with that tag. This helps your readers know your favorite subjects and
the topics you write about most frequently. 

## 󠀁[How to add a Tag Cloud block to your post or page](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#how-to-add-a-tag-cloud-block-to-your-post-or-page)󠁿

Add the _Tag Cloud block_ to your post or page by clicking on the “Block Inserter”(
+) and then search for “Tag Cloud”. Alternatively, you can type `/tag-cloud` in 
a new paragraph block and press `enter`.

![How to add a Tag Cloud block](https://wordpress.org/documentation/files/2024/04/
image-1.png)

[Detailed instructions on adding blocks](https://wordpress.org/documentation/article/adding-a-new-block/)

If you have tags/categories on your site, the _Tag Cloud block_ will display a list
of the tags as follows:

![Preview of a Tag Cloud block](https://lh4.googleusercontent.com/hCtqFBzOn9j8H4JiNzQLFGYd0qkwDMJfdA08NPnuUegtBNXCCnaWDPOv8jT3NPFrBez1z6DI7WvsHbYOYAREktz040z873suDbtBKRh7Qjd6ChV6_bKrtvWWVjUbr_jjdVuI56E)

If the site doesn’t have any tags then it will display the message as shown below.

![When there are no tags to show, the block displays a text that says "There's no
content to show here yet."](https://wordpress.org/documentation/files/2020/08/tag-
clould-no-content-WP-62-1024x166.png)

**Note: **Tags’ appearance varies based on the selected theme.

## 󠀁[Block toolbar ](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#block-toolbar)󠁿

Each block has its own block-specific controls that allow you to customize the block
right in the editor. The _Tag Cloud block_ offers the following options in its toolbar:

 * Transform to
 * Drag
 * Move handles
 * Change alignment
 * More Options.

### 󠀁[Transform to](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#transform-to)󠁿

![Transform options in the Tag Cloud block](https://wordpress.org/documentation/
files/2022/07/Screen-Shot-2022-07-19-at-5.05.21-PM.png)

When you click on the **Transform** button you can convert the _Tag Cloud block 
_into a Categories List, Columns, or Group. The Group lets you change the background
color around the Tag Cloud block. You can also change the Tag Cloud styles from 
Default to Outline.

![Editor view of an Tag Cloud block as a group with Color Settings controls](https://
wordpress.org/documentation/files/2022/07/171654193-d567206e-27ef-436b-b26a-3f608faa48b6-
1024x223.png)

![Tag Cloud block with a yellow background.](https://wordpress.org/documentation/
files/2022/07/171654025-c209b1b6-d786-44d4-a4d6-d648d24d0a41-1-1024x428.png)

### 󠀁[Drag](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#drag)󠁿

To drag and drop the block to a new location on the page template, click and hold
the rectangle of dots, then drag to the new location. The blue separator line indicates
where the block will be placed. Release the left mouse button when you find the 
new location to place the block.

### 󠀁[Move handles](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#move-handles)󠁿

The up and down arrow icons can be used to move a block up and down on the page.

[[[Get more information about moving a block within the editor.](https://wordpress.org/documentation/article/moving-blocks/)

### 󠀁[Change alignment  ](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#change-alignment)󠁿

![Change alignment in the Tag Cloud block](https://wordpress.org/documentation/files/
2022/07/Screen-Shot-2022-07-19-at-5.08.19-PM.png)

 * **Wide width** – Increase the width of the Tag Cloud block beyond the content
   size.
 * **Full width** – Extend the Tag Cloud block to cover the full width of the screen.
 * **Align left** – Make the Tag Cloud left aligned
 * **Align center** – Make the Tag Cloud aligned center.
 * **Align right **– Make the Tag Cloud right aligned.

**Note:** “Wide width” and “Full width” alignment is only available if it is enabled
by the Theme of your site. 

### 󠀁[More options](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#more-options)󠁿

These controls give you the option to copy, duplicate, and edit your block as HTML.

[Read about these and other settings.](https://wordpress.org/documentation/article/more-options/)

## 󠀁[Block settings](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#block-settings)󠁿

Every block has specific options in the editor sidebar in addition to the options
found in the block toolbar. If you do not see the sidebar, simply click the ‘settings’
icon next to the Publish button.

### 󠀁[Settings tab](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#settings-tab)󠁿

#### 󠀁[Taxonomy](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#taxonomy)󠁿

Select from the following three [taxonomy](https://wordpress.org/documentation/article/taxonomies/)
types: Categories, Tags, or Pattern Categories. The Tag Cloud is displayed based
on the selected taxonomy.

#### 󠀁[Show post counts](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#show-post-counts)󠁿

Toggle the switch to display the number of posts associated with the taxonomy.

#### 󠀁[Number of tags](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#number-of-tags)󠁿

Move the slider or type in a number to change the number of taxonomy terms that 
can be displayed in the Tag Cloud.

![Number of tags in the Tag Cloud block](https://wordpress.org/documentation/files/
2020/08/image-3.png)

#### 󠀁[Smallest size/largest size](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#smallest-size-largest-size)󠁿

Change the smallest and largest font size that can be used in the Tag Cloud. You
can change the font size unit between PX, %, EM, REM, VW, VH.

![Font size in the Tag Cloud block](https://wordpress.org/documentation/files/2022/
07/Screen-Shot-2022-07-19-at-5.35.39-PM.png)

![The block settings sidebar with the settings tab opened.](https://wordpress.org/
documentation/files/2023/04/tag-cloud-settings-tab-WP-62-415x1024.png)

### 󠀁[Styles tab](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#styles-tab)󠁿

#### 󠀁[Styles](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#styles)󠁿

You can modify the _Tag Cloud block_ styles by choosing the ‘Default’ or ‘Outline’
buttons in the Styles settings panel. Hover over the ‘Default’ or ‘Outline’ buttons
to get a preview of the styles.

The style options may vary based on your theme.

#### 󠀁[Typography](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#typography)󠁿

Typography settings allow you to change a block’s font size, appearance, line height,
letter casing, and spacing.

[Get more details about changing typography settings.](https://wordpress.org/documentation/article/typography-settings-overview/)

#### 󠀁[Dimensions](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#dimensions)󠁿

Dimension controls are used to control how groups of blocks are placed alongside
one another, by changing the values for padding, margin, and other dimensions

[Learn more about dimension controls.](https://wordpress.org/documentation/article/dimension-controls-overview/)

![The block settings sidebar with the styles tab opened.](https://wordpress.org/
documentation/files/2023/04/tag-cloud-styles-tab-WP-62-414x1024.png)

### 󠀁[Advanced](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#advanced)󠁿

The Tag Cloud block provides the following Advanced settings options: HTML anchor,
Additional CSS Class(es), and Styles.

[Learn more about advanced settings](https://wordpress.org/documentation/article/advanced-settings-overview/)

## 󠀁[Changelog](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#changelog)󠁿

 * Updated 2026-05-25 (props @kjoyner @awetz583)
    - Updated “Advanced” section to refer to new overview page
 * Updated 2024-04-23
    - Updated formatting
 * Updated 2023-03-30
    - Updated screenshots.
    - Added information about typography options.
 * Updated 2023-01-26
    - Updated for formatting consistency.
 * Updated 2022-11-26
    - Alinged images for mobile view .
    - Removed redundant content .
 * Updated 2022-11-17
    - Updated screenshots and content for 6.1.
 * Updated 2022-07-19
    - Added content and screenshots for 6.0.
    - Added ALT tags for images.
 * Created 2020-08-17

## Was this article helpful? How could it be improved? 󠀁[Cancel reply](https://wordpress.org/documentation/article/tag-cloud-block/?output_format=md#respond)󠁿

[Log in to submit feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fwordpress.org%2Fdocumentation%2Farticle%2Ftag-cloud-block%2F&locale=en_US).
If you need support with something that wasn't covered by this article, please post
your question in the [support forums](https://wordpress.org/support/forums/).

First published

August 17, 2020

Last updated

May 25, 2026