FAQ & troubleshooting

Quick answers to common questions, and a checklist for when something does not look right.

General

Does ShapeOption work with variable products?
Yes. Shoppers pick a variation as usual and fill in the options. Percentage prices follow the chosen variation’s price.
Is there a limit on groups, fields or sites?
No. Both plugins allow unlimited option groups, fields and sites.
Will it slow down my store?
The storefront script is small, plain JavaScript with no jQuery or framework, and it only loads where an option group is shown.
Can I translate it?
Yes. Both plugins are translation ready and work with WPML and Polylang.
Is it compatible with HPOS and the Cart/Checkout blocks?
Yes, both are supported.
Do I need the free plugin to use Pro?
No. Pro is standalone. See Free vs Pro.
Can I keep the free plugin and Pro active together?
Yes, but they keep separate groups and both show their own. Move your groups to Pro, then deactivate the free plugin — see Moving from free to Pro.

Pricing

Can an option lower the price?
Yes. Use a negative price for a discount. The final price never goes below zero.
Why does the cart show a different total than the product page?
The cart works prices out again on the server. Check quantity tiers (they depend on the cart quantity) and coupons or dynamic pricing plugins that change the base price.
Are fees taxed?
Fees are added to the product price, so they follow the product’s tax class and your tax display settings.

Uploads

Which files can customers upload?
jpg, jpeg, png, gif, webp, pdf, zip and txt. You can allow fewer per field. Risky types such as .php or .svg are not on the list, so they cannot be uploaded.
Where are the files?
In a protected folder inside wp-content/uploads with random names. Pro can send them to S3-compatible storage.

Troubleshooting

My fields do not show on the product page
Check, in order:
  1. The group is published (status Live).
  2. The Show on rule matches the product, and it is not under Exclude.
  3. Visible to includes your role — test logged out too.
  4. The product is not external or grouped.
  5. Your theme prints the standard Add to Cart form. If it uses a custom layout, place the group with the shortcode or block (Pro).
  6. Clear page and theme caches.
The total does not update live
Open your browser console and look for JavaScript errors from another plugin or theme. Script combining/minifying plugins can also break the order of scripts — exclude ShapeOption’s scripts and test again.
A field I hid is still required
Hidden fields are never required. Make sure the rule refers to the choice value (not the label) and that the field is in the same group.
No shipping methods at checkout
Two options in the cart allow no shipping method in common. Review the Shipping methods lists — see Shipping by option.
I cannot change the quantity in the cart
The product uses Repeat per quantity. Use Edit options to change the quantity and entries together.
Options disappeared after a theme change
Some themes move or remove the Add to Cart hooks. Switch the placement, or use the shortcode or block (Pro).

Need more help?

Still stuck? Contact support with your ShapeOption and WooCommerce versions and a screenshot of the option group. We are happy to help.
Was this page helpful?

Leave a Reply

Your email address will not be published. Required fields are marked *