Frequently Asked Questions

Basic Functionality

↑ Back to top

Some items do not appear or cannot be purchased in Composite products, although they appear to be saved correctly.

↑ Back to top

Products that are part of a Composite Product must have a price assigned, even when Priced Individually is unticked. WooCommerce does not allow products with a blank price to be purchased.

The add-to-cart button of a Composite product cannot be clicked, or does not appear at all.

↑ Back to top

If the Composite product does not contain any Components that are Priced Individually, make sure that a price has been entered in the Regular Price field, located in the Product Data > General tab.

If this is in order, the cause might be due to a conflict with a third-party theme or plugin. To diagnose script-related issues with third party themes or plugins, follow this guide to see if there are any script-related errors in your browser. The easiest way to find the cause of such issues is to: (a) revert to a default WordPress theme and (b) start disabling plugins one by one, until you find the one that’s responsible.

Note that products included in composites must have a non-blank price, as well.

How coupons apply for composites/components

↑ Back to top

A coupon is invalid for a Component if its parent composite product is specifically excluded.
A coupon is valid for a Component if it is valid for its parent composite product.

Coupons which are limited to apply to only 1 cart item, will apply only to the first eligible product in the cart. When you add a Composite Product to the cart, one cart item is created:

  • for the parent Composite item, and;
  • for each composited item.

When applying a limited coupon to the cart, it applies to each cart item individually. Therefore, a coupon with items count limit set to 1 will apply only to the container Composite product and not to all components as well. If you have component items that are priced individually and are limiting coupons this way, we recommend setting the limit to the number of components included in the composite product + 1 for the base price of the composite product.

The mini-cart widget of my theme does not show the correct count of cart items.

↑ Back to top

Composite product contents are not counted. A Composite product is counted as one item, no matter how many products it contains.

If your theme is counting cart items in a different way, ensure that it uses the WC()->cart->get_cart_contents_count() method to count cart items. If unsure how to verify this, share this information with your theme author(s).

The single-product details of my Composite products appear squeezed.

↑ Back to top

Many WooCommerce themes place single-product summaries next to the main product image, which is ideal for displaying a short product description, a price and some metadata. Add-to-cart form content is normally displayed inside the single-product summary as well, which works very well for displaying simple or variable products.

However, this layout is not ideal for complex product types, such as composites, which require more space for their add-to-cart form content.

If the form content of your Composite products appears narrow or squeezed, choose the Form Location > Before Tabs option and see if it works better for you. Alternatively, try this plugin to move the add-to-cart form under the product image and summary.

Is there a way to make a product available only within a Composite?

↑ Back to top

In many cases it is desirable to make a product available only within a Composite. This is possible by changing the Catalog Visibility of this product to hide it from the catalog/search of your site. Hidden products will still show up in any Composites that contain them.

Why don’t I see express payment/quick pay buttons on my Composite Product pages?

↑ Back to top

Composite Products do not support quick-pay buttons on the product pages. These buttons are not currently compatible with forms that have multiple fields on the product page.

Does the extension support Variable products?

↑ Back to top

Composite Products allows you to add Variable-type products as Component Options. However Variable products support comes with a number of limitations:

  • It is not possible to offer Variations as Component Options.
  • The extension is not optimized for Variable products with a large number of variations. When choosing a Variable product in a Component, it may take a long time to load and display product details, as the extension requires all available variation data to be loaded when the variable product is chosen.
  • When using Scenarios to conditionally exclude specific variations, Variable product prices in Dropown, Radio Buttons and Thumbnails option templates are not dynamically updated based on the active/compatible variations.

My website becomes slow/unresponsive when the extension is activated.

↑ Back to top

When creating large, complex Composite products with many product/variation options, you may experience slow page-load speeds if you are on a shared hosting environment with limited resources.

Running an e-commerce website requires a fast hosting environment with sufficient resources dedicated to complex database queries. Choosing a cheap or low-quality host hurts the uptime and performance of your website, resulting in lost sales and costly upgrades.

Poorly-coded themes can also have a serious impact on page-load speeds, especially when using complex extensions such as Composite Products. If you are experiencing slow page load speeds on the front-end: (a) switch to the default WordPress theme and (b) disable all third-party plugins one by one, remembering to re-test after each change.

The following tips are also useful for diagnosing performance-related issues:

  • The shop prices of Composite products are based on calculating the cheapest possible configuration. For complex Composite products with individually-priced Components that contain many product/variation options, this can be a resource-intensive process. For the best possible performance in large-scale applications, it is highly recommended to tick the Hide Price option, which bypasses all internal logic associated with finding the cheapest possible configuration. It is located in the Product Data > General tab.
  • Use the Thumbnails Options Style with Components that contain more than ~20-30 products. The Dropdown and Radio Buttons styles require all product data to be loaded at once and have a negative impact on performance as the number of Component Options increases.
  • For the best possible performance, ensure that you are running the latest versions of WooCommerce and Composite Products.

Issues with auto-optimizer plugins.

↑ Back to top

Auto-optimizer plugins prevent Composite Products scripts from running, which causes issues with the extension’s basic functionality. More specifically, when auto-optimizer plugins are used, the composite product form does not load.

The extension is sometimes loading Component Options in the background. Is there a way to prevent this?

↑ Back to top

When creating large Composite products with many Component Options, the extension will try to decrease page load speeds by loading some data “on demand”. However, if you are using a full page cache, you may prefer to pre-load as much data as possible in order to take full advantage of it.

To disable lazy-loading for all Components and Composites, use the following snippet/plugin:

View on Github

Advanced Concepts

↑ Back to top

Is it possible to choose multiple options under a single Component?

↑ Back to top

Yes. However, you will need Product Bundles in addition to Composite Products. Read more in Store Owner’s Guide – Beyond Basics.

How do I handle failed loopback request notices in from Composite Products?

↑ Back to top

If loopback requests do not work correctly in your store, this indicates a server misconfiguration or code conflict which is preventing your site from making requests to itself. This issue can affect core WooCommerce and WordPress functionalities such as database and plugin updates.

Specifically for Composite Products, if loopback requests are not working correctly on your site, then:

  • The stock of composited items will not be updated correctly when a composite is purchased. 
  • The Catalog Price will not be correctly calculated for composite products.

To get loopback requests working on your site:

  • Contact Your Hosting Provider: Reach out to your hosting provider and request that they enable loopback requests. When contacting them, include a screenshot of the Tools > Site Health tab from your WordPress dashboard, as it provides more details about the issue.
  • Check for Plugin or Theme Conflicts: Sometimes, conflicts with other plugins or themes can cause issues.

Can I add a Composite Product to the cart using a specially-constructed Add to Cart URL?

↑ Back to top

To create a custom Composite Add to Cart URL, please follow the steps below:

  1. Edit the Composite.
  2. Navigate to Product Data > Components.
  3. Check the ‘Edit in cart‘ option and Update the product.
  4. Click to view the Composite, configure its components and add it to the cart.
  5. In the cart, click the edit option.
  6. Copy the URL after removing the update-composite parameter.
  7. Add an add-to-cart=$ID parameter, replacing ‘$ID’ with the ID of the Composite Product you are working on.

Why do I see a States tab instead of a Scenarios tab?

↑ Back to top

States is a legacy tab and has been replaced by the Scenarios tab since version 8.0.

That being said, the States tab does not show up (only Scenarios will show up) in Components that were created:

  • after installing v 8.0+,
  • with a previous version but didn’t include any Scenarios with the ‘Activate Options’ action enabled, or;
  • with a previous version but didn’t include any Scenarios before the update.

How can I programmatically generate different scenarios?

↑ Back to top

Note: We are unable to provide support for customizations under our Support Policy. If you need to extend Composite Products’ functionality, seek assistance from a qualified WordPress/WooCommerce Developer. We highly recommend Codeable, or a Certified WooExpert.

In some advanced use cases developers may wish to generate different product scenarios programmatically.

In this case you can use the woocommerce_composite_scenario_meta filter included in the extension. The best way to understand how the data is organized is to create a scenario manually via the admin edit screen and then examine its array contents.

To create scenarios programmatically and save that data in the database, we recommend calling WC_Product_Composite::set_scenario_data and then save.

Customizations and Integrations

↑ Back to top

I need to make a customization.

↑ Back to top

Customizations are not covered under our Support Policy. However, we encourage you to have a look at the available mini-extensions and snippets. If the customization you are looking for is not included there, please seek assistance from a WordPress/WooCommerce developer. We highly recommend a Certified WooExpert.

Is the extension compatible with [insert plugin/extension name here]?

↑ Back to top

The official WooCommerce extensions supported by Composite Products are listed in the Compatibility and Integrations section. Third party extensions/plugins are not supported.

I have an issue with WPML!

↑ Back to top

For compatibility with WooCommerce, WPML relies on the WooCommerce Multilingual plugin.

Composite Products does not support WPML directly. If you are experiencing any issues, please reach out to WPML support.

Is there a way to edit a text string in the plugin?

↑ Back to top

You can use a plugin such as Loco Translate to edit text strings. This is the best way to customize WooCommerce text strings, as the edits will not be overwritten when plugins are updated.

After activating Loco Translate:

  1. Go to Loco Translate > Plugins and click Composite Products.
  2. Click on New Language.
  3. Choose the desired or your site’s default language in the dropdown menu.
  4. Select Custom in the Choose a location option.
  5. Press Start Translating.
  6. Search for the string you want to edit.
  7. Select it and add your modification.
  8. Press Save.

For more details visit Generating a New Translation.

Orders and Fulfillment

↑ Back to top

Is it possible to manually add/modify Composite products in editable orders?

↑ Back to top

Yes!

If a Composite product contains configurable Components, a Configure button is appended to the title of the order item. Clicking the Configure button brings up a modal that allows Store Managers to:

  • choose configuration options; and
  • add the configured Components to the order.

If a Composite product does not contain any configurable Components, all static Components are added to the order along with the parent/main order item — in this case, no action is required.

Questions & Support

↑ Back to top

Have a question? Please fill out this pre-sales form.
Already purchased and need assistance? Get in touch with us via the Help Desk!