Gatemi Checkout Fields FAQ and Troubleshooting

My new field does not appear on the checkout

  1. Is Show ticked? A new row starts unticked.
  2. Did it get a key? A row with no key is not saved.
  3. Is your checkout the classic one? Open the Checkout page in the editor: if it contains the Checkout block rather than the [woocommerce_checkout] shortcode, see the next question.
  4. Free edition: was the field created by the full edition as something other than text? Those are left off the free edition's checkout.

Does it work with the Checkout block?

Yes — and for your own fields, differently by edition.

  • Changes to WooCommerce's own billing and shipping fields — rename, reorder, require, hide — act on both checkouts, in both editions. The block draws one address form for billing and shipping, so an edit reaches it when the two addresses agree on it (a field only one address has, such as the phone, counts on its own). A country's own rule — Germany's postcode, the UK's County — stays WooCommerce's. The email address and the country are not address-form fields on the block and are not changed there.
  • Free edition: your own text fields appear on the classic checkout only.
  • Full edition: your own fields are registered with the block too (the Block checkout setting, on by default). Text, Dropdown and Checkbox keep their type there; other types become a text box. WooCommerce stores block-checkout values under its own keys and shows them on the order itself.

I hid a field but it is still on the checkout

On the Checkout block, check that you hid it in both the billing and the shipping address — the block draws one form for both, so a field shown in one stays. On either checkout, also check that another plugin or the theme does not add the field back after this plugin runs.

Where do I enter a dropdown's choices? — Full edition

In the Choices box under the field's type: one choice per line, key|Label (sm|Small), or a label on its own. A Dropdown or Radio buttons field with no choices offers nothing to pick. The gmcf_fields filter can still supply or change them in code — see the developer reference.

The field's value is not in the emails

Free edition: your fields are shown on the order screen, not in emails. Full edition: tick Emails under Show it on for that field. Values from the Checkout block are handled by WooCommerce's own additional-fields display.

Can I make a core field optional?

Yes — untick Required. Bear in mind your payment gateway or shipping plugin may need the field (for example a postcode for live rates). WooCommerce's country rules can also make an address field required or optional on top of this.

Does it work with HPOS?

Yes. Values are written and read through the order object, and the block under the billing address appears on both the HPOS and the classic order screen.

Does it work with page caching?

Yes. The checkout is never served from a page cache, and the plugin loads no storefront script or stylesheet.

Can I rename the order notes field?

Yes. It is order_comments in Additional fields.

Moving from the free edition to the full edition

Install and activate the full edition; the free edition stands down. Both use the option gmcf_fields and the gmcf_ prefix, so every rename, order, requirement and hidden field carries over, and every past order's values still show.

Going back to the free edition, be careful with the full edition's typed fields: the free edition's screen saves only Show, Key, Label, Order and Required, so pressing Save changes there rewrites a dropdown or date field you created in the full edition as a plain text field.

What does uninstalling remove?

  • Free edition: deletes gmcf_fields, but only when the full edition has never been configured on this site (neither gmcf_settings nor gmcf_license exists).
  • Full edition: deletes gmcf_fields, gmcf_settings, gmcf_license, the cached update data and the licence-check cron event.
  • Neither removes anything from orders. What customers typed stays on each order.
Shopping Cart
Scroll to Top