Gatemi Product Add-Ons FAQ and Troubleshooting

The options do not show on the product page

  1. Free edition: check the slot has a Label — an empty label leaves it unused. Full edition: check the field has a Title.
  2. The options are printed on WooCommerce's woocommerce_before_add_to_cart_button hook, inside the add-to-cart form. A page builder or block template that draws its own add-to-cart button without that hook will not show them.
  3. Grouped and external products have no add-to-cart form of their own, so they show no options.
  4. Full edition: for a variable product, the fields appear after a variation is chosen.

Is a fee charged once or per unit?

  • Free edition: once per cart line. Three engraved mugs on one line carry one engraving fee: the fee is spread over the line's unit price, so the line total includes it exactly once, and changing the quantity re-spreads the same fee.
  • Full edition: you choose. Flat fee is once per line; Per quantity is per unit; Percentage of the price is per unit.

Can I make an option required?

Full edition: tick Required on the field. The free edition's options are always optional.

The fee is added twice when the cart updates

It should not be: both editions add the fee once, however many times the cart recalculates. If you see it doubled, another plugin may be changing the same cart line's price; deactivate other pricing plugins to find which.

Does it work with the Cart and Checkout blocks?

Yes. Choices are made on the product page, and the cart line carries them, so the blocks show them like any other cart item data. Full edition: add-to-cart requests through the Store API are translated and validated the same way as the classic form.

Shop-page "Add to cart" skips my options

Free edition: options are optional, so a product added from a listing is added without them. Full edition: a product with a required field shows Select options on listings and links to its page.

Does it work with page caches?

Yes. The fields are part of the product page and contain nothing personal. Carts and checkouts should never be page-cached anyway.

Does it work with HPOS?

Yes. Choices are written as ordinary order line-item meta.

The Stripe or PayPal express button disappeared from a product

Full edition: on a product with add-ons, express buttons are hidden on the product page because a one-tap payment would skip the fields.

Can I move my options from the free to the full edition?

Yes, with nothing to do. The free edition stores its options in _gmpaf_addons; the full edition keeps its own in _gmpa_addons. For any product the full edition has not saved yet, it reads the free options and shows them in its own shape — a text option as a flat-fee Custom text field, a checkbox option as a Checkbox field with one flat-fee option — so the product page and cart behave as before. The free row is never changed or removed; the first time you save the product in the full edition's panel, it writes its own. Past orders keep the choices recorded on them either way.

Can I import from WooCommerce Product Add-Ons?

Full edition: yes, from WooCommerce → Product Add-Ons. The import reads that plugin's data and never changes it, so you can compare before switching.

What does uninstalling remove?

  • Free edition: every product's options (_gmpaf_addons) — but only when the full edition has never been configured on the site (no gmpa_settings or gmpa_license option). Once it has, the options are left in place, because the full edition reads them. Choices on past orders stay on the orders.
  • Full edition: its settings, the import ledger, the licence state and caches. Add-ons and global groups are removed only if Delete all data on uninstall is on. Order records and uploaded files are kept.
Shopping Cart
Scroll to Top