Product Page Variant Table
The Product Page Variant Table feature embeds a high-density, multi-variant ordering table directly on your store’s Product Detail Pages (PDP). It empowers B2B buyers to select quantities for multiple product variants (sizes, colors, materials) and bulk add them to the cart or send a quote request in a single click.
1. Overview & Business Value
Section titled “1. Overview & Business Value”Standard Shopify product pages typically limit shoppers to selecting one variant at a time through dropdown selectors. For B2B wholesale buyers purchasing dozens of variant combinations, this requires tedious, repetitive clicks.
- The buyer opens a product page.
- The Variant table app block shows every variant with a quantity field.
- The buyer enters quantities for several variants.
- They click Add to cart to add everything at once, or Add to quote to send the variants to the quote form.
Key Merchant Benefits:
Section titled “Key Merchant Benefits:”- Faster Bulk Ordering: Buyers enter quantities across all available variants on a single screen.
- Transparent Pricing & Stock: Live variant prices, SKUs, and inventory availability are displayed in dedicated columns.
- Dual Action Support: Supports both Add to Cart (for immediate purchase) and Add to Quote (for quote negotiation).
2. Before You Begin
Section titled “2. Before You Begin”- Theme App Embed: Verify that the B2B Portal app embed is turned on in your Shopify Theme Editor.
- App Block Integration: The table is rendered via Shopify’s Theme App Extension. You must add the Variant table app block to your Product template in the Shopify Theme Editor.
3. Configuration via Shopify Theme Editor
Section titled “3. Configuration via Shopify Theme Editor”
In the app, go to Quick Order, open Quick Order settings in the More section, and click Variant table. It has an Add to theme button that opens your Shopify Theme Editor. All visual and functional settings are customized directly inside the Theme Editor sidebar:
3.1 Adding the App Block
Section titled “3.1 Adding the App Block”- In Shopify Admin, navigate to Online Store > Themes > Customize.
- From the top dropdown menu, select Products > Default product (or your specific product template).
- In the left sidebar under the Product Information section, click Add block.
- Select Variant table (under Apps). It used to be called BSS Product Page Variant Table. A block you added before the rename keeps working.
- Drag the block to your preferred position (e.g., directly below the price or product description).
- Click Save in the top-right corner to publish your configuration.
3.2 Block Schema Settings
Section titled “3.2 Block Schema Settings”| Setting | Type | Description |
|---|---|---|
| Compatible with BSS Request for Quote | Toggle | When enabled, renders an Add to Quote button alongside Add to Cart if the product matches an active Quote logic rule. |
| Columns > Image | Toggle | Displays the variant thumbnail image column. |
| Columns > SKU | Toggle | Displays the variant SKU code column. |
| Columns > Stock | Toggle | Displays real-time warehouse inventory availability. |
| Columns > Line total | Toggle | Displays dynamically calculated line total per variant row. |
| Enable bulk quantity input | Toggle | Adds a master quantity input in the table header to apply the same quantity across all variants simultaneously. |
| Enable quick fix for variant errors | Toggle | After Apply, shows a Quick fix button that corrects invalid quantities and out-of-stock rows in one click. |
| Quick fix rounding for quantity rule | Round up / Round down | How Quick fix rounds a quantity that breaks the quantity rule. If rounding up would exceed available stock, it rounds down instead. |
| Default sort order | Dropdown | Order in which variants first appear. Default keeps the variant order set in Shopify admin. Other options: Title (A-Z / Z-A), Price (low to high / high to low), SKU (A-Z / Z-A). |
| Show sort dropdown | Toggle | Lets buyers change the variant order from the table toolbar. The order the buyer sees first is always the Default sort order. |
| Primary color | Color Picker | Customizes the background color of primary action buttons. |
| Text color | Color Picker | Customizes the label text color of primary action buttons. |
4. Storefront Buyer Experience
Section titled “4. Storefront Buyer Experience”-
Inline Quantity Inputs: Buyers enter required quantities for each variant row.
-
Bulk Quantity Applicator: When enabled, entering a number in the master quantity field at the top fills all variant rows in one click.
-
Quantity Rules: Automatically respects Shopify Quantity Rules (minimum order quantities, maximum limits, and pack size increments).
-
Out-of-Stock Protection: Variants with zero inventory (and backordering disabled) are grayed out with an “Out of stock” label.
-
One-Click Action: Clicking Add to Cart or Add to Quote processes all entered variants simultaneously.
-
Sorting: Variants first appear in the Default sort order. If Show sort dropdown is on, buyers can re-sort by title, price or SKU.
-
Store languages: Table labels, buttons and messages follow the language the buyer browses your store in. The app ships these texts in 21 languages and falls back to English for any other language.
-
Custom texts: To change the wording, go to Settings > Languages and click Variant table. Edit the texts for each store language and check them in the live preview. Keep the placeholders in double curly braces, such as
{{title}}or{{count}}: the app does not save a text that is missing one. Editing the English texts needs the Growth plan; other languages need the Business plan or higher. A customer sees your text for their language first, then the built-in text for that language, then your English text.
5. Technical & Platform Constraints
Section titled “5. Technical & Platform Constraints”- Create Quick Order PageBuild a Quick Order page: choose who can see it and which products it lists, set the layout, filters and search, then publish it.
- Create Universal PageShare one Quick Order link with every customer group: the universal page sends each customer to the Quick Order pages they can use.
- CSV Upload (Bulk Import)Let B2B buyers upload a CSV, XLSX or XLS file of SKUs and quantities to fill a large order on a Quick Order page in seconds.
- Custom CSS for Quick Order PagesAdd your own CSS to a Quick Order page from your theme: how to add it, which bss-qo-* class names are stable.