Themeisle Docs

Appearance

PPOM Troubleshooting guide ​

To troubleshoot issues related to product releases or specific circumstances, follow these steps. This document will guide both you and us in collecting the necessary data for effective troubleshooting.

🔁 Update Software ​

  • Ensure you are using the latest versions of PPOM Free and Pro. More details about updating to the latest version can be found here.
  • Make sure you have installed a recent version of PHP.

👁 PPOM fields are not visible on the product page ​

If PPOM fields are not showing on a product page even though the meta group appears to be correctly assigned, work through the following checklist in order.

1. Check that the product has a valid price

PPOM fields render as part of the WooCommerce purchase workflow, alongside the Add to Cart button. If the product has no valid WooCommerce price, WooCommerce may treat it as non-purchasable, which prevents PPOM fields from appearing.

  • Simple products: Go to Products > Edit product > Product data > General > Regular price and confirm a price is set.
  • Variable products: Open the Variations tab and confirm that each relevant variation has a price set.

📝 Note: A blank price is not the same as a zero/free price. WooCommerce treats a product with a blank price as non-purchasable. If the product is intended to be free, enter 0 in the Regular price field rather than leaving it blank.

2. Confirm the PPOM meta group is attached

Verify that the correct PPOM meta group is attached to the product, its category, or its tag. For details on all available attachment methods, see Attach meta groups to products.

After making any changes, click Save on both the PPOM field group and the product.

3. Clear all caches and retest

After confirming the price and the meta group assignment:

  • Clear your WordPress page cache (e.g. WP Rocket, W3 Total Cache, LiteSpeed Cache).
  • Clear your server-level cache and CDN cache if applicable.

Open the product page in an incognito or private browsing window to confirm PPOM fields are now visible.

🗄️ Caching Interference ​

  • If newly configured PPOM fields are not visible on the product page, a caching plugin (e.g. WP Rocket, W3 Total Cache) is likely serving a stale version of the page. Clear your cache after making changes, or verify using an incognito/private browsing window.

✅ Required fields do not show validation errors ​

If customers can add a product to the cart without completing a required PPOM field, or if the required-field error message never appears, work through the following checks in order.

1. Confirm the field is marked Required

  1. Open the product in the WordPress editor and go to its PPOM field group.
  2. Click the affected field to expand its settings.
  3. Make sure the Required toggle is turned on.
  4. Click Save to save the field group.

2. Enable Client-Side Validation

PPOM includes a client-side validation option that checks required fields before the Add to Cart request is sent. If this setting is off, some field types (such as Select fields) may not display an error message.

  1. Go to WooCommerce > Settings > PPOM Settings > Pro Settings > Basic Settings.
  2. Enable the Enable Client-Side Validation option.
  3. Save the settings.

3. Clear all caches and retest

After saving your changes, clear every cache layer before testing:

  • Clear your WordPress page cache (e.g. WP Rocket, W3 Total Cache, LiteSpeed Cache).
  • Clear your server-level cache (e.g. Nginx FastCGI cache, hosting panel cache).
  • Clear your CDN cache if you use one (e.g. Cloudflare, BunnyCDN).
  • Temporarily disable any JavaScript minification, deferral, or delay features in your optimization plugin while testing, as these can prevent PPOM's validation scripts from loading correctly.

Open the product page in an incognito or private browsing window to confirm the changes are live and no old cache is loaded, then try to add the product to the cart without completing the required field.

🔍 Run a conflict test for validation issues ​

If required-field validation still does not work after the steps above, the issue is likely caused by a theme or plugin conflict on your site.

  1. Install the free Health Check & Troubleshooting plugin.
  2. Use its Troubleshooting Mode to switch to a default theme (e.g. Twenty Twenty-Four) and disable all plugins except WooCommerce and PPOM for your admin session only — your live site visitors are not affected.
  3. Open the product page and test whether required-field validation works in this clean environment.
  4. If validation now works, re-enable your plugins one by one (and then your theme) until the conflict reappears. The last item you re-enabled is the likely cause.

Alternatively, perform this test on a staging copy of your site.

Refer to the general WordPress Troubleshooting Guide for a full step-by-step conflict-testing workflow.

🛠 Identify Plugin Conflicts ​

  • There are old NMedia users who still have those NMedia add-ons installed. When we acquired PPOM, we changed the structure so that those add-ons are now integrated into the plugin. As a result, there is no longer any need to have those add-ons installed separately.
  • Please refer to this troubleshooting guide to check for plugin conflicts: Troubleshooting Guide.

🧰 Install Query Monitor ​

  • If you cannot find errors, install the Query Monitor plugin and check if something appears when performing certain actions, like adding a product to the cart or saving fields.

📤 Share Meta Fields Export ​

🚀 Style Settings ​

  • The PPOM meta fields can be easily customized using the in-built style settings. To learn more about this, check the documentation - How To Style PPOM fields?.

🔒 No more fields/options ​

  • The warning message that appears when you try to add new inputs indicates that the number of input variables sent in a request has exceeded the PHP configuration limit, which is set to 1000 by default. This can happen when a form submits a large number of inputs, such as checkboxes, input fields, or parameters. To resolve this issue, you need to increase the max_input_vars setting in your php.ini file. Here are the steps you need to follow to do this - https://serverpilot.io/docs/how-to-increase-max_input_vars/.

By following these steps, you can help us diagnose and resolve issues effectively. If you encounter any difficulties, refer to this document to ensure we have the necessary information to assist you.

Contact us on the dedicated channels - pro users or free users.