{"id":429,"date":"2026-09-07T05:04:40","date_gmt":"2026-09-07T05:04:40","guid":{"rendered":"https:\/\/shapekode.com\/product\/optionfroge\/docs\/optionfroge-documentation\/faq-troubleshooting\/"},"modified":"2026-10-26T11:02:37","modified_gmt":"2026-10-26T11:02:37","slug":"faq-troubleshooting","status":"publish","type":"docs","link":"https:\/\/shapekode.com\/product\/shapeoptions\/docs\/optionfroge-documentation\/faq-troubleshooting\/","title":{"rendered":"FAQ & troubleshooting"},"content":{"rendered":"\n

Quick answers to common questions, and a checklist for when something does not look right.<\/p>\n\n\n\n

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

Pricing<\/h2>\n\n\n\n
Can an option lower the price?<\/summary>
Yes. Use a negative price for a discount. The final price never goes below zero.<\/div><\/details>
Why does the cart show a different total than the product page?<\/summary>
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.<\/div><\/details>
Are fees taxed?<\/summary>
Fees are added to the product price, so they follow the product\u2019s tax class and your tax display settings.<\/div><\/details><\/div>\n\n\n\n

Uploads<\/h2>\n\n\n\n
Which files can customers upload?<\/summary>
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.<\/div><\/details>
Where are the files?<\/summary>
In a protected folder inside wp-content\/uploads with random names. Pro can send them to S3-compatible storage.<\/div><\/details><\/div>\n\n\n\n

Troubleshooting<\/h2>\n\n\n\n
My fields do not show on the product page<\/summary>
Check, in order:
  1. The group is published<\/strong> (status Live<\/em>).<\/li>
  2. The Show on<\/strong> rule matches the product, and it is not under Exclude<\/strong>.<\/li>
  3. Visible to<\/strong> includes your role \u2014 test logged out too.<\/li>
  4. The product is not external or grouped.<\/li>
  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).<\/li>
  6. Clear page and theme caches.<\/li><\/ol><\/div><\/details>
    The total does not update live<\/summary>
    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 \u2014 exclude ShapeOption\u2019s scripts and test again.<\/div><\/details>
    A field I hid is still required<\/summary>
    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.<\/div><\/details>
    No shipping methods at checkout<\/summary>
    Two options in the cart allow no shipping method in common. Review the Shipping methods<\/strong> lists \u2014 see Shipping by option<\/a>.<\/div><\/details>
    I cannot change the quantity in the cart<\/summary>
    The product uses Repeat per quantity<\/strong>. Use Edit options<\/strong> to change the quantity and entries together.<\/div><\/details>
    Options disappeared after a theme change<\/summary>
    Some themes move or remove the Add to Cart hooks. Switch the placement, or use the shortcode or block (Pro).<\/div><\/details><\/div>\n\n\n\n

    Need more help?<\/p>

    Still stuck? Contact support with your ShapeOption and WooCommerce versions and a screenshot of the option group. We are happy to help.<\/div><\/div>\n\n\n","protected":false},"featured_media":0,"parent":418,"menu_order":15,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"nav_title":"","positive":"","negative":"","footnotes":""},"docs_category":[],"class_list":["post-429","docs","type-docs","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs\/429","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/comments?post=429"}],"version-history":[{"count":19,"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs\/429\/revisions"}],"predecessor-version":[{"id":570,"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs\/429\/revisions\/570"}],"up":[{"embeddable":true,"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs\/418"}],"wp:attachment":[{"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/media?parent=429"}],"wp:term":[{"taxonomy":"docs_category","embeddable":true,"href":"https:\/\/shapekode.com\/product\/shapeoptions\/wp-json\/wp\/v2\/docs_category?post=429"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}