Features of the variant list on the product page
- Table or variant cards. Two presentation layouts for the same product combinations, with the list adapted to phone screens.
- Attribute comparison. Each item shows the names of groups and attribute values assigned to the combination, for example size and color.
- Variant search. The customer searches by attribute value names and by reference or EAN, if the store owner has enabled the display of a given code.
- Attribute filters. Dropdown lists allow narrowing results by product attribute values. With more than 200 different attribute values, the module skips dropdown filters and leaves search available.
- Pagination for a long list. You can set from 5 to 100 variants per page; 20 are displayed by default. The customer sees the number of matching variants and navigation between pages.
- Combination images. If a variant has an assigned image, the list uses it. If the combination has no image, it can display the product cover image.
- Reference and EAN. Each of these codes can be shown or hidden independently to adjust the amount of information to the store’s ordering method.
- Prices consistent with PrestaShop. The module uses the store’s calculations taking into account the customer, customer group, currency, and tax calculation method. The list shows the unit price for the minimum purchase quantity; the final value and quantity discounts are calculated by the cart.
- Availability information. The list distinguishes variants in stock, available for order despite being out of stock, and unavailable variants. When stock management is disabled, it shows general availability.
- Optional exact stock quantities. By default, the number of units is hidden, and the customer still sees the availability status. The owner can enable quantity display for variants in stock.
- Links to variants. The name and image lead to the product page with the selected combination, allowing the customer to switch to the standard purchase form.
Ordering multiple variants in one action
- Separate quantities for variants. The customer enters the number of units for selected combinations and adds them with one shared button to the native PrestaShop cart.
- Up to 50 variants of one product. One action covers a maximum of 50 different combinations of the same product. Each of them can have a different ordered quantity.
- Selection preserved between filters and pages. Entered quantities remain selected while using the list on the open product page, even when some items disappear after applying a filter.
- Selection summary. The list shows the number of selected variants and the total number of units. The clear button removes the entire selection, including items outside the current page.
- Minimum purchase quantity taken into account. Quantity control takes into account units of a given variant already in the cart. After reaching the minimum, the customer can add a smaller additional quantity if the remaining purchase rules allow it.
- Available stock control. With stock management enabled, the module takes into account quantities in the cart and the option to order out-of-stock products set in PrestaShop.
- Quantity limit in one action. The owner sets from 1 to 100,000 units added for a single variant; the default limit is 1000. This is not a limit on the total quantity of that variant in the cart.
- Retry after connection interruption. The module recognizes a retry of the same request in the same session and for 48 hours protects against adding its confirmed items again. In case of an uncertain result, it indicates the need to check the cart.
- Messages for individual variants. If adding ends partially, the customer receives information about the result and errors for rejected items. From the list, they can go directly to the cart.
Settings for the store owner
- Choosing the location on the product page. Available positions are the product tab, its footer, the area below the purchase button, or a custom place in the template. The position of standard sections depends on the hooks called by the theme.
- Restriction to selected categories. In the panel, you can enter category IDs separated by commas. The list appears for products assigned to at least one of them; an empty field means no category restriction.
- Show only variants in stock. This option hides combinations with zero or negative stock, even when the store allows ordering them without stock.
- In-stock variants first. An independent setting allows combinations with positive stock to be placed before the others.
- Title in store languages. The owner can enter a custom list title for individual languages and enable or disable its header. An empty title field uses the module’s default translation.
- Comparison list without bulk ordering. You can disable shared purchasing and keep the presentation of variants and links to their pages.
- Three configuration tabs. The PD panel organizes options into the Display, Ordering, and Instructions tabs, with a description of how it works and how to embed the list in a custom location.
- Settings separately for each store. In a multistore installation, the configuration is saved in the context of a single store. The list uses its combinations and native stock rules, including the shared warehouse of the store group.
Practical benefits for the customer and the store
- Shared purchase of several sizes or colors. The customer prepares a selection within one product and adds it to the cart with one button.
- Easier finding of the right combination. Search and filters narrow a long list, and preserving the selection allows searching for more variants without re-entering previous quantities.
- Data tailored to the type of sales. The store can highlight images and colors or focus on references, EANs, and quantities for wholesale orders.
- Purchase consistent with store rules. The customer uses prices, minimums, and availability set in PrestaShop, and the owner decides on the scope of the list and additional add-to-cart limits.
Example uses
In a clothing store, the customer can select several sizes and colors of the same model and enter the quantity for each combination. In the sale of parts or accessories, the list organizes variants distinguished by attributes and references. For wholesale orders, it allows entering different quantities for several combinations of one product, taking into account prices and minimums configured in the store.
How does the customer use the variant list?
- They open a product with combinations and browse the table or variant cards.
- Optionally, they narrow the list using search and filters and move between pages.
- They enter quantities for selected variants, using the summary of the number of items and units.
- They add the selection with one shared button, read the result, and check the contents of the native PrestaShop cart.
Important operating rules
- The module presents combinations already created in PrestaShop. It does not generate new variants or create a feature table for products without combinations.
- Bulk purchase applies to variants of one product. The list is not used to select multiple separate products from a category.
- Products with required personalization fields use the native product form. Bulk ordering remains disabled for them even after saving the personalization.
- Catalog mode, hidden prices, or disabled product ordering block bulk purchase. Available variant information can still be used for comparison.
- Filtering, page switching, and bulk ordering require JavaScript. The list also contains links to variants and instructions for purchasing through the standard product form.
- Before adding, the module checks all selected variants. Rejection at this stage does not add any item; an error during cart update may result in a partial outcome, about which the customer is informed.
Compatibility and implementation
Supported PrestaShop versions: 1.7, 8, and 9. The availability of the selected list position depends on the product page template. For a custom embedding location, the module provides the displayCustomAttributesListTable hook and instructions for its use in the panel. The required PHP version should be matched to the PrestaShop version in use.
Link to the module demo version:
Admin panel demo version:
https://moduly-prestashop.eu/szybkie-dodwanie-kombinacji/admin-dev
User interface demo version:
https://moduly-prestashop.eu/szybkie-dodwanie-kombinacji