PPOM Pro for WooCommerce - Settings Reference

PPOM Pro (Personalized Product Option Manager) is a WooCommerce plugin that lets you add custom product option fields — text inputs, image selectors, file uploads, date pickers, and more — to any product in your store. You can find all plugin settings under WooCommerce > Settings > PPOM Settings in the WordPress admin.

General Settings

Basic Settings

Disable Bootstrap

When enabled, the plugin stops loading its bundled Bootstrap JS from a CDN. You would enable this if your theme or another plugin already loads Bootstrap, since loading it twice can cause JavaScript conflicts and visual glitches on your product pages.

Legacy Inputs Rendering

When enabled, the plugin reverts to the plugin’s older input rendering method. Turn this on if your product option fields look wrong or behave unexpectedly on the front end after an update. Once you have confirmed that the current rendering works correctly on your site, you can leave this off.

Legacy Conditions Script

When enabled, the plugin uses an older version of its conditional-logic script. Turn this on if you notice that field visibility conditions (show/hide rules between fields) stopped working correctly after an update.

Enable Legacy Price Calculations

When enabled, the plugin falls back to an older method for calculating option prices. Use this if you encounter incorrect totals or pricing display issues with the current calculation engine.

PPOM Permissions

A multi-select dropdown that controls which WordPress user roles can manage PPOM field groups. By default only the Administrator role has access. You would add other roles here if, for example, you want Shop Managers or custom roles to create and edit product option fields without full admin access. The Administrator role cannot be removed from this list.

Restricted File Types

A comma-separated list of file extensions that customers are not allowed to upload through PPOM file-upload fields. The default list blocks common executable and server-side script formats (php, php4, php5, php6, php7, phtml, exe, shtml). Add any additional file types you want to block, or remove entries if your use case requires them.

Label Settings

Option Total Label Inside Price Table

Sets the label shown next to the option-price subtotal row in the front-end price breakdown table. Defaults to "Option Total." Change this if you want different wording, for example "Add-on Total" or "Extras."

Product Price Label inside Price Table

Sets the label shown next to the base product price row in the price breakdown table. Defaults to "Product Price."

Total Label inside Price Table

Sets the label shown next to the grand-total row in the price breakdown table. Defaults to "Total."

Total Discount Label Inside Price Table

Sets the label shown next to the discount row in the price breakdown table when a discount applies. Defaults to "Total Discount."

Option Total Suffix

An optional text string appended after the option total in the price table. Use this to display tax or VAT information such as "VAT Included" or "excl. Tax." Left empty by default.

Pro Settings

This panel and all settings within it require the Pro version of the plugin. In the free version these settings appear locked.

Basic Settings

Hide Images in Cart

When enabled, image-type field selections are not shown as thumbnails in the WooCommerce cart. Enable this if the cart page looks cluttered when customers select multiple images, or if you prefer a text-only cart display. This setting is Pro only.

Uploaded Image Resize Proportionally

By default the plugin crops uploaded images into a square thumbnail. When enabled, uploaded images are resized proportionally instead, preserving their original aspect ratio. Enable this if your product options involve non-square images such as logos or banners. This setting is Pro only.

Clear Fields After Add to Cart

When enabled, all PPOM fields on the product page reset to their defaults after the customer clicks Add to Cart. This is useful when customers are likely to add the same product multiple times with different options, so they start fresh each time. This setting is Pro only.

Enable Client-Side Validation

When enabled, required-field checks and format validation happen in the browser before the form is submitted. This gives customers faster feedback on missing or invalid entries without a page reload. This setting is Pro only.

Do Not Send Product Meta to PayPal Invoice

When enabled, only the product name is sent to the PayPal invoice — the individual option details are omitted. Enable this if your option labels are very long and cause formatting problems in PayPal, or if you prefer to keep customization details private from the payment gateway. This setting is Pro only.

Shop Add to Cart Label

Sets the text shown on the Add to Cart button on archive (shop) pages when a product has PPOM fields attached. Defaults to "Select Options." You might change this to "Customize" or "Choose Options" to better match your store's language. This setting is Pro only.

Price Settings

Override Product Price

When enabled, the displayed product price on archive and single-product pages reflects the lowest available option price from the attached PPOM fields, rather than the base WooCommerce price. Use this when your option prices effectively replace the product price and you want customers to see the real starting cost. This setting is Pro only.

Hide Variable Product Price

When enabled, the default WooCommerce price range shown below the title of variable products is hidden whenever PPOM fields are attached. This prevents confusion when the PPOM price table already shows the full breakdown. This setting is Pro only.

Hide Options Price

When enabled, individual option prices are hidden from the labels of Select, Radio, Checkbox, and Image inputs. Customers still see the total in the price table, but not the per-option cost. Use this if you want to simplify the appearance or avoid drawing attention to individual surcharges. This setting is Pro only.

Taxable Options Price

When enabled, the tax rules you have configured under WooCommerce > Settings > Tax are applied to PPOM option prices. Leave this off if your option surcharges are already tax-inclusive or if options should not be taxed. This setting is Pro only.

Apply Tax on Fixed/Cart Fee

When enabled, any fixed-price or cart-fee-type PPOM surcharges become taxable under your WooCommerce tax settings. This is separate from the regular option price tax setting and applies specifically to fees that are added as flat amounts. This setting is Pro only.

Price Table Position

Controls whether the front-end price breakdown table appears before or after the PPOM fields on the product page. Options are "After PPOM Fields" (default) and "Before PPOM Fields." This setting is Pro only.

Advanced Settings

Delete Unused Images

Sets how often the plugin cleans up images uploaded through PPOM fields that were never purchased (for example, from abandoned carts). Options are Daily (default), Weekly, and Monthly. After changing this setting, you must deactivate and reactivate the plugin for the new schedule to take effect. This setting is Pro only.

Meta Group Overrides

Controls how PPOM field groups assigned at the category level interact with groups assigned to individual products. "Default" applies both without overriding. "Category Overrides Individual Assignment" means a category-level group replaces any product-level group. "Individual Overrides Category Assignment" means a product-level group replaces any category-level group. Leave this on Default unless you have a specific reason to change it. This setting is Pro only.

Meta Group Priority

When both a category-level and a product-level PPOM field group apply to the same product, this setting controls which one renders first. "Category First" shows the category group above the product group; "Individual First" does the opposite. Leave this on the default unless you need to control the display order. This setting is Pro only.

Fields Settings

This panel requires the Pro version. In the free version these settings appear locked.

Fields Popup

Enable Fields Popup

When enabled, PPOM fields on all products are displayed inside a popup overlay instead of directly on the product page. This can simplify your product pages, especially for products with many options. This setting requires a Plus license.

Button Label

Sets the text on the button that opens the fields popup. Leave blank to use the default. This setting requires a Plus license.

Button Text Color

Sets the text color of the popup trigger button. This setting requires a Plus license.

Button Background Color

Sets the background color of the popup trigger button. This setting requires a Plus license.

Collapse Field

Multiple Collapse Open

When enabled, customers can expand multiple collapsible field sections at the same time. By default only one section can be open at a time, accordion-style. This setting is Pro only.

Hide Headline Arrow

When enabled, the small arrow icon that appears next to collapse section headlines is hidden. This setting is Pro only.

Collapse Icon Position

Controls whether the collapse/expand icon appears on the left or the right of the section headline. Defaults to Right. This setting is Pro only.

Collapse Text Color

Sets the text color of collapse section headlines in their closed state. This setting is Pro only.

Collapse Background Color

Sets the background color of collapse section headlines in their closed state. This setting is Pro only.

Collapse Open Text Color

Sets the text color of collapse section headlines when the section is expanded. This setting is Pro only.

Collapse Open Background Color

Sets the background color of collapse section headlines when the section is expanded. This setting is Pro only.

Allow Next/Prev

When enabled, Next and Previous navigation buttons appear on collapsible sections, letting customers step through them sequentially instead of clicking each headline. This setting is Pro only.

Field Repeater

Clone Title

Sets the tooltip text shown when a customer hovers over the clone (duplicate) icon in a repeater field group. This setting requires a Plus license.

Remove Title

Sets the tooltip text shown when a customer hovers over the remove (delete) icon in a repeater field group. This setting requires a Plus license.

Icons Size

Sets the size of the clone and remove icons in pixels. Defaults to 20px. Enter a value such as "25px" to make the icons larger. This setting requires a Plus license.

Clone Mode

Controls how fields are duplicated when a customer clicks the clone icon. "Clone from first box only" always copies the original set of fields. "Clone from each box" copies the specific set the customer clicked on, preserving any values already entered. This setting requires a Plus license.

Clone Icons Position

Controls whether the clone and remove icons appear at the top or bottom of each repeater field group. This setting requires a Plus license.

Icons Library

Selects which icon set is used for the clone and remove buttons. Options are Dashicons (WordPress built-in) and FontAwesome. This setting requires a Plus license.

Bulk Quantity

Display Type

Controls the visual layout used for bulk-quantity fields. "Bulk Quantity Standard" shows a straightforward quantity table. "Bulk Quantity Packaged" groups quantities into pre-defined packages. This setting is Pro only.

Cart Edit

This panel requires the Pro version with a Plus license. In the free version it appears locked.

Enable PPOM Cart Edit

When enabled, customers can modify the PPOM option values they selected after adding a product to the cart. Without this, customers must remove the item and add it again to change options. This setting requires a Plus license.

Popup Edit

When enabled, the cart-edit interface opens in a popup overlay rather than expanding inline on the cart page. This keeps the cart layout cleaner, especially for products with many fields. This setting requires a Plus license.

Edit Options Text

Sets the label for the button or link customers click to start editing their options in the cart. Defaults to "Edit Options." This setting requires a Plus license.

Edit Button Class

Lets you add one or more custom CSS class names (separated by spaces) to the edit-options button in the cart. Use this to match the button styling to your theme. This setting requires a Plus license.

Fields Modal

When enabled, the full set of PPOM fields for a cart line item is displayed inside a modal dialog instead of inline on the cart page. This differs from Popup Edit in that it shows the complete field set rather than just an edit interface. This setting requires a Plus license.

Model Button Label

Sets the label for the button that opens the fields modal in the cart. This setting requires a Plus license.

Enquiry Form

This panel requires the Pro version. In the free version it appears locked.

Emails Recipients

A comma-separated list of email addresses that receive enquiry form submissions. If left empty, enquiries go to the site admin email.

Note

A message displayed at the top of the enquiry form, visible to customers before they submit. Defaults to "All selected data will be sent to vendor." Change this to set expectations about what happens with the submitted data.

Send Message

The confirmation message displayed to the customer after they successfully submit the enquiry form. Use this to thank the customer or let them know when to expect a response.

Button Title

Sets the text label on the enquiry form submit button. Leave blank for the default.

Button Class

Lets you add one or more custom CSS class names (separated by commas) to the enquiry form button for custom styling.

Button Text Color

Sets the text color of the enquiry form submit button.

Button Background Color

Sets the background color of the enquiry form submit button.

Send Enquiry Form Data to User

When enabled, a copy of the enquiry submission is also emailed to the customer who submitted it. This gives customers a record of what they requested.

Hide Add to Cart Button

When enabled, the standard WooCommerce Add to Cart button is hidden on product pages that have an enquiry form. Use this when you want enquiry-only products where customers cannot purchase directly.

Event Calendar

This panel only appears when the Pro version is active.

Hide Quantity Box

When enabled, the WooCommerce product quantity input is hidden on products that use the Event Calendar field. This is useful when the calendar itself determines the quantity (for example, number of days or event slots selected).

PDF

This panel only appears when the Pro version is active. It controls the appearance of PDF documents generated from PPOM product meta on orders.

PDF Header

An HTML textarea where you can enter custom header markup for generated PDF documents. Use inline CSS for styling. The default header shows your site name centered on a light background.

PDF Footer

An HTML textarea where you can enter custom footer markup for generated PDF documents. Use inline CSS for styling. The default footer shows your site URL.

Disable Header/Footer

When enabled, the default header and footer sections are removed from generated PDFs entirely. Enable this if you want a cleaner PDF or if your custom header/footer content is included directly in the PDF body template instead.

Style Settings

This panel requires the Pro version. In the free version it appears locked.

General Settings

Field Label

A typography control (font size, line height, and font color) that styles the labels of all PPOM fields on the front end. Use this to match field labels to your theme's typography without writing custom CSS.

Field Description

A typography control (font size, line height, and font color) that styles the description text shown below PPOM fields.

Options Label

A typography control (font size, line height, and font color) that styles the text labels next to individual options in select, radio, checkbox, and image fields.

Options Price Label

A typography control (font size, line height, and font color) that styles the price text shown next to option labels.

Input Box Settings

Background Color

Sets the background color of all PPOM text inputs, select dropdowns, and textareas on the front end.

Text Color

Sets the text color inside all PPOM text inputs, select dropdowns, and textareas.

Border Style

A border editor (width, style, and color for each side) that controls the border of all PPOM inputs, selects, and textareas in their default state.

Border Focus Style

A border editor that controls the border appearance of PPOM inputs, selects, and textareas when they are focused (clicked into). Use this to provide a visible focus indicator that matches your theme.

Box Shadow Focus

Sets the CSS box-shadow applied to PPOM inputs when focused. Enter a standard CSS box-shadow value such as 0 0 0 0.2rem rgb(0 123 255 / 25%). Set the value to "none" to disable it entirely.

Price Table Settings

Text Color

Sets the text color inside the PPOM price breakdown table (both header and data cells).

Background Color

Sets the background color of the PPOM price breakdown table.

Tooltip Settings

Icon Color

Sets the color of the tooltip trigger icon (the small icon next to fields that have tooltip help text configured).

Max. Width

Sets the maximum width of tooltip popups in pixels. Defaults to 500px. Increase this if your tooltip content is lengthy, or decrease it for a more compact look.

Text Color

Sets the text color inside tooltip popups.

Background Color

Sets the background color of tooltip popups.

Border Color

Sets the border color of tooltip popups.

Position

Controls which side of the trigger icon the tooltip appears on. Options are Top, Bottom, Left, and Right.

Animation

Controls the entrance animation used when a tooltip appears. Options are Fade, Grow, Swing, Slide, and Fall.

Interactive

When enabled, customers can move their cursor into the tooltip content and interact with it (for example, to select text or click links inside the tooltip). When disabled, the tooltip disappears as soon as the cursor leaves the trigger icon.

Open Tooltip on click

When enabled, tooltips open when the customer clicks the trigger icon instead of hovering over it. This is helpful on touch devices where hover is unreliable, or when you want tooltips to stay visible until explicitly dismissed.

Integrations

This panel requires the Pro version. In the free version it appears locked.

REST API

PPOM REST API

When enabled, the plugin exposes a REST API endpoint that external applications can use to read and interact with PPOM field data. Leave this off unless you have a specific integration that needs programmatic access to PPOM.

Secret Key

A string of characters that serves as an authentication key for REST API requests. Any API call must include this key to be accepted. Choose a strong, unique value and share it only with trusted integrations.

WCFM Vendors

Allow Vendors to Create/Edit PPOM Fields

When enabled, vendors using the WCFM (WooCommerce Frontend Manager) marketplace plugin can create and edit PPOM field groups from their vendor dashboard. The field groups vendors create are global, meaning they are available to all products. This setting only takes effect if the WCFM plugin is installed and active.

Store Title

Sets the label displayed on the product edit page for the PPOM fields section in the WCFM vendor interface. Defaults to "Custom Fields."