web_taxonomy_terms_thumbnails Shortcode
The web_taxonomy_terms_thumbnails shortcode presents terms from one selected taxonomy as a responsive thumbnail grid. Its available taxonomies come from the current site's posts, pages, POM content models and, when active, WooCommerce.
The attributes below match the current Page Builder controls and public output. Use raw syntax only for reviewed content that cannot be maintained through the visual controls.
Usage
[web_taxonomy_terms_thumbnails]Attributes
| Attribute | Default | Accepted values | Purpose |
|---|---|---|---|
taxonomy |
— | A taxonomy offered by the Page Builder control | Selects the source taxonomy. The list adapts to registered post, page, POM content-model and supported WooCommerce taxonomies on the current site. |
layout |
default |
default, simple |
Selects the card presentation. |
top_level_only |
— | yes or empty |
Limits hierarchical results to terms without a parent. |
child_of_term_with_id |
— | One term ID | Shows direct children of the specified parent term. |
specific_child_terms |
— | Comma-separated term IDs | Includes only the specified terms. |
excluded_terms |
— | Comma-separated term IDs | Excludes the specified terms. |
number |
-1 |
Integer; -1 for all matching terms |
Limits the number of returned terms. |
columns |
3 |
12, 6, 4, 3, 2, 1 |
Sets the number of result columns. |
columns_tablet |
12 |
12, 6, 4, 3, 2, 1 |
Controls the number of columns (tablet). |
columns_mobile |
12 |
12, 6, 4, 3, 2, 1 |
Controls the number of columns (mobile). |
orderby |
name |
name, slug, term_id, description, parent, term_order, meta_value_num, menu_order |
Selects the sorting field. meta_value_num and menu_order use the saved category position. |
order |
DESC |
ASC, DESC |
Controls the order. |
display_thumbnail |
yes |
yes |
Controls the display thumbnail. |
image_size |
thumbnail |
Any registered WordPress image-size slug | Selects the generated term-thumbnail size. |
display_background_image |
yes |
yes |
Controls the display background image. |
background_image_size |
full |
full or any registered WordPress image-size slug |
Selects the generated copy used for a local background image. External image URLs remain unchanged. |
display_title |
yes |
yes |
Controls the display title. |
display_color |
— | yes |
Controls the display color. |
title_color |
1 |
String unless stated otherwise | Choose title color. |
title_alignment |
right |
left, right, under, tooltip |
Choose title alignment. |
title_size |
h4 |
display-1, display-2, display-3, display-4, h1, h2, h3, h4, h5, h6, custom |
Choose title size. |
display_description |
— | yes |
Controls the display description. |
description_color |
1 |
String unless stated otherwise | Choose description color. |
show_empty_terms |
— | yes |
Controls the show empty terms. |
link_term_to_archive |
yes |
yes |
Controls the link each term to archive. |
display_only_related_to_post |
— | yes |
Controls the display only the terms related to the post. |
display_only_related_to_current_category |
— | yes |
If the module is in a category archive, only those related to that category will be displayed. |
device_visibility |
— | String unless stated otherwise | Applies the selected responsive visibility rule. |
el_id |
— | Valid unique HTML ID | Enter section ID (Note: make sure it is unique and valid according to w3c specification). |
el_class |
— | String unless stated otherwise | If you wish to style particular content element differently, then use this field to add a class name and then refer to it in your css file. |
Ordering by category position
Choose Menu order in the module's Order by control and ASC in Order to follow the positions saved by dragging categories in WordPress. The Page Builder stores this choice as orderby="meta_value_num". HTML templates can also use orderby="menu_order" with the same result:
[web_taxonomy_terms_thumbnails taxonomy="category" orderby="menu_order" order="ASC" top_level_only="yes"]Replace category with your taxonomy slug. Use DESC to reverse the saved positions. For WooCommerce product categories (product_cat), both values use WooCommerce's category ordering. Term order is a separate WordPress option and does not select POM's saved category positions.
Verification
Preview the grid with a taxonomy that has local images, descriptions and nested terms. Compare Full with a generated size such as Medium and confirm the background URL changes to the selected copy without affecting the separate thumbnail size. Then verify the chosen include, exclude or parent rule and the configured column count at desktop, tablet and mobile widths.
To verify category ordering, save positions that differ from alphabetical order and preview the shortcode with orderby="menu_order" order="ASC". Confirm it matches Menu order in the Page Builder, then use DESC to check the reverse order.