---
title: Build a Bulk Pricing Products List with a Shortcode
description: "Publish a WooCommerce wholesale price list with the products-list shortcode, including price-by-quantity levels."
url: "https://wpfactory.com/docs/bulk-pricing-products-list-shortcode/"
updated: "2026-09-27"
category: Shortcodes
---

# Build a Bulk Pricing Products List with a Shortcode

The products-list shortcode outputs a table of products with columns you choose, including price-by-quantity levels, so you can publish a wholesale price list on any page. This is a Pro shortcode in [Price by Quantity & Bulk Quantity Discounts for WooCommerce](https://wpfactory.com/item/product-price-by-quantity-for-woocommerce/). This article also covers the language shortcode.

### `[alg_wc_ppq_products_list]`

Renders a product table. Long-form alias: `[alg_wc_wholesale_pricing_products_list]`. Both names behave the same.

| Attribute | Description | Default |
| --- | --- | --- |
| `columns` | Pipe-separated column definitions, each as `value:Title`. See the column values below. | `sku:SKU|name:Name|category:Category|price_with_add_to_cart_link:Price|levels:from %level_min_qty% pcs.` |
| `levels` | Manual levels as `qty:discount` pairs joined by `|`, used to build the level columns when no category is given. | `false` |
| `category_slug` | Limit the list to one product category and read its per-category levels. | `false` |
| `discount_type` | Force a discount type (`percent`, `fixed` or `price_directly`) for the level columns. | `false` |
| `limit` | Maximum products to list. `-1` means no limit. | `-1` |
| `orderby` | Product ordering field passed to WooCommerce. | `date` |
| `order` | `ASC` or `DESC`. | `DESC` |
| `image_size` | Image size for image columns. | `woocommerce_thumbnail` |
| `use_transients` | Cache the rendered table for 10 minutes. `yes` or `no`. | `no` |

#### Column values

Each entry in `columns` starts with one of these values, followed by `:` and the heading text:

- `sku`, `name`, `category`, `price`, `image`: the basic product fields.
- `price_excl_tax`, `price_incl_tax`: price with or without tax.
- `levels`: one column per pricing level, showing the discounted per-unit price.
- Any of the above with the `_with_add_to_cart_link` suffix (for example `name_with_add_to_cart_link`) wraps the cell in an add-to-cart link. Use `image_with_product_link` to link the image to the product page instead.
- `meta:<meta_key>:Title`: output a product meta value, for example `meta:total_sales:Total sales`.

**Example:** `[alg_wc_ppq_products_list columns="sku:SKU|name:Name|price:Price|levels:from %level_min_qty% pcs." category_slug="bulk-supplies"]`

![products list shortcode output on a page](https://wpfactory.com/wp-content/uploads/bulk-pricing-products-list-shortcode-1.png)

### `[alg_wc_ppq_translate]`

Shows or hides text based on the active WPML language, useful inside pricing tables and labels. It works two ways:

- With attributes only: `[alg_wc_ppq_translate lang="EN,DE" lang_text="Text for EN and DE" not_lang_text="Text for other languages"]`
- Wrapping content: `[alg_wc_ppq_translate lang="EN,DE"]Text for EN and DE[/alg_wc_ppq_translate]`, or use `not_lang="EN,DE"` to show the wrapped text everywhere except those languages.

For the translation troubleshooting workflow, see [how to translate the price by quantity table and plugin strings](/docs/translate-price-by-quantity/).

**Note:** the free `[alg_wc_wholesale_pricing_table]` and `[alg_wc_product_wholesale_pricing_table]` shortcodes are covered in the [Price by Quantity shortcodes](/docs/shortcodes-for-price-by-quantity-plugin/) article.

### Ready to set this up?

The products-list shortcode is a Pro feature of [Price by Quantity](https://wpfactory.com/item/product-price-by-quantity-for-woocommerce/). Upgrading unlocks it along with per-variation, per-category and per-tag pricing. [Get Price by Quantity Pro](https://wpfactory.com/item/product-price-by-quantity-for-woocommerce/).

Related articles

- [Shortcodes for the Price by Quantity Plugin](https://wpfactory.com/docs/shortcodes-for-price-by-quantity-plugin/)
- [Quantity Discounts by Product Category and Tag](https://wpfactory.com/docs/woocommerce-quantity-discounts-by-category-and-tag/)
- [Show Real-Time Price by Quantity on the Product Page](https://wpfactory.com/docs/woocommerce-price-display-by-quantity/)
- [Quantity Pricing Per Variation](https://wpfactory.com/docs/woocommerce-per-variation-quantity-pricing/)
- [How to Set Quantity Discounts on a Single Product](https://wpfactory.com/docs/woocommerce-per-product-quantity-pricing/)