WooCommerce / Product Table
Every Product Table shortcode attribute. Anything you leave out uses Table Defaults for columns, rows per page, design, and width, then the built-in default shown here.
Shortcode: [yh_wc_product_table]. The block prints the same shortcode from its sidebar, but the sidebar does not include every attribute. Filters, variations, quick view, cart summary, guest columns, and design templates are shortcode-only.
| Attribute | Default | Notes |
|---|---|---|
columns | image,name,summary,price,buy | Comma-separated. Heading override: name:Item. |
rows_per_page | 25 | Max 200. -1 for one page. |
product_limit | 500 | Max products queried. Hard cap 1000. |
width | normal | normal, wide, full. |
design | default | default, modern, classic, minimal, dark, green, purple, red. |
image_size | 70x70 | 150x150 or a registered image size. |
lightbox | true | Click image to enlarge. |
links | all | all, none, or column names. |
wrap | true | Wrap long text. |
hide_header | false | Hide the heading row. |
sticky_header | false | Keep the heading visible while scrolling. |
custom_class | Empty | Extra class on the <table>. |
column_widths | Empty | name:40%,sku:90px. |
hide_columns_guest | Empty | Columns removed for logged-out visitors. |
description_length | 15 | Words in summary and description. -1 for the full text. |
shortcodes | false | Run shortcodes in summary and description. |
date_format | Empty | PHP date format for the date column. |
button_text | Show details | Label of the button column. |
no_products_message | Empty | Text when the query returns nothing. |
no_products_filtered_message | Empty | Text when search or a dropdown hides every row. |
| Attribute | Default | Notes |
|---|---|---|
category | Empty | Category slugs, comma-separated. |
exclude_category | Empty | Category slugs to skip. |
tag | Empty | Tag slugs. |
include | Empty | Product IDs to keep. |
exclude | Empty | Product IDs to skip. |
status | publish | Shoppers always get published products. |
product_type | Empty | simple, variable, grouped, external. |
min_price | 0 | No minimum when 0. |
max_price | 0 | No maximum when 0. |
in_stock_only | false | In-stock products only. |
on_sale_only | false | Sale products only. |
featured_only | false | Featured products only. |
taxonomy | Empty | Taxonomy name, used with term. |
term | Empty | Term slug. |
| Attribute | Default | Notes |
|---|---|---|
search_box | Bottom | top, bottom, both, false. |
search_term | Empty | Pre-filled search. search is an alias. |
instant_search | false | Search as you type. |
pagination | Bottom | top, bottom, both, false. |
page_length | Bottom | “Show X entries”. Same positions. |
totals | Bottom | “Showing X of Y”. Same positions. |
paging_type | numbers | numbers, simple, simple_numbers, full, full_numbers. |
load_more | false | Load more button instead of page numbers. |
lazy_load | false | AJAX rows. |
cache | false | Cache the product query. |
sort_by | menu_order | Column to sort on first load. |
sort_order | asc | asc or desc. |
filters | Off | categories,stock,att:color:Color. |
reset_button | false | Reset search, dropdowns, and sort. |
| Attribute | Default | Notes |
|---|---|---|
cart_button | button | button, checkbox, or button_checkbox. Both checkbox values render a checkbox. |
ajax_cart | true | Add without a reload. |
quantities | false | Quantity field in the buy column. |
multi_add | false | Select all and Add selected. Needs a checkbox buy column. |
footer_cart | false | Cart summary under the table. |
floating_cart | false | Floating cart button. |
direct_checkout | false | Go to checkout after a successful add. |
quick_view | false | Quick view icon in the buy column. |
variations | dropdown | dropdown, rows, or false. |
variation_name_format | name_attributes | name_attributes, name_only, attributes_only. Used with variations="rows". |
| Attribute | Default | Notes |
|---|---|---|
responsive_visibility | Empty | sku:desktop,stock:tablet. Desktop hides under 1024px. Tablet hides under 768px. |
column_priority | Empty | name:1,price:2. Lower numbers stay visible longer. 1–10. |
Automatic shop, category, tag, search, and attribute tables are configured under WooCommerce → Product Table → Shop Integration, not with these attributes. For a page builder template, choose Manual and place [yh_wcpt_archive_table]. That shortcode does not take attributes. It uses the Shop Integration settings for the current page, including the current category, tag, search, or attribute.
A normal shortcode on a category page does not inherit that category. Pass category="the-slug" yourself, or use [yh_wcpt_archive_table] so the archive supplies it.