Text input
Single-line custom text. Example: engraved name.
Complete user guide
Ultimate Product Addon Documentation
Install, configure, and manage WooCommerce product add-ons, flexible pricing, visual swatches, product bundles, recipient addresses, customer consent, and order-ready customization data.
What the plugin does: It adds advanced product customization fields to WooCommerce, calculates add-on pricing live, and carries the customer selections into cart, checkout, orders, and emails.
No matching documentation
Try a field name, feature, or setup term such as bundle, pricing, address, or import.
Step 01
Install the plugin
- Download the plugin ZIP file from your BricksUltimate account or the beta download link.
- Go to WordPress Dashboard > Plugins > Add New > Upload Plugin.
- Upload the ZIP file and click Install Now.
- Click Activate Plugin after WordPress finishes installing it.
- Make sure WooCommerce is installed and active, because the add-ons are attached to WooCommerce products.
After activation, you will see the Ultimate Addons menu in the WordPress dashboard.
Step 02
Activate your license key
- Open WordPress Dashboard > Ultimate Addons > License.
- Paste your license key into the license field.
- Click Activate License.
- When the license is active, the button changes to Deactivate License.
- Keep the license active to receive plugin updates from your store account.
The license key is stored encrypted in the database when encryption is available on the server.
Step 03
Create Global Groups
Global Groups are reusable add-on groups. Use them when the same options should appear on many products, such as gift wrap, delivery date, color choices, custom text, uploads, or measurement fields.
- Go to Ultimate Addons > Add Global Groups.
- Click Add Group.
- Enter the group name, optional description, and choose whether to show them on the frontend.
- Choose Group by Category or Group by Product.
- Select the product categories or products where this group should appear.
- Add fields inside the group and configure labels, help text, pricing, options, defaults, and conditional logic.
- Click Save Changes.
Example:
Create a Gift Options group, assign it to the Clothing category, then add Gift wrap, Gift message, and Delivery date fields.
Step 04
Create independent product add-ons
Product-level add-ons are best when one product needs its own custom options. When product-level add-ons are enabled, they replace matching global add-ons for that product.
- Go to Products and edit the WooCommerce product.
- Open the Product Data panel.
- Click the Product Add-Ons tab.
- Enable Product add-ons to override global add-ons for this product.
- Create groups and fields just like the Global Groups builder.
- Update the product.
Example:
For a custom poster product, add a Measurement / Area Pricing field, paper finish swatches, and an artwork upload field only for that product.
Reference
Field types
Choose the field type based on what the customer needs to provide or select.
Email field
Validated email input with an email keyboard and autocomplete. Example: gift recipient or digital delivery email.
Phone field
Validated international-friendly phone input. Example: callback or delivery contact number.
URL field
Validated HTTP or HTTPS website address. Example: social profile, reference page, or inspiration URL.
Textarea
Longer message or notes. Example: gift message.
Address field
Grouped recipient name, street, city, state, ZIP/postal code, and country inputs. Example: a gift delivery destination.
Terms / consent checkbox
Required acceptance with optional linked terms. Example: proof approval, custom-order terms, or a no-refund agreement.
Number
Numeric input. Example: number of labels or extra pieces.
Checkbox
One or more extra choices. Example: gift wrap and priority handling.
Radio buttons
One choice from a visible list. Example: standard or premium packaging.
Select dropdown
One choice in a compact dropdown. Example: product size.
Multi-select
Multiple values in one field. Example: pizza toppings.
Color swatches
Visual color choices with modern layouts. Example: fabric color.
Image swatches
Image-based choices. Example: texture, finish, material, or style.
Product selector
Let customers choose one or more real WooCommerce products as an add-on, using product card or full-width layouts.
Product Bundle Add-On
Add real products or variations as linked bundle cart items with configurable layout, price, quantity, and stock behavior.
File upload
Customer file attachment. Example: artwork or logo upload.
Date picker
Calendar date selection. Example: delivery or pickup date.
Time picker
Time slot selection. Example: appointment or pickup time.
Heading / paragraph
Informational text inside the form. Example: section instructions.
HTML content block
Custom content block for richer instructions or notices.
Measurement / Area Pricing
Width, height, and length inputs with area or volume pricing. Example: custom blinds, glass, prints, or fabric.
Product quantity add-on
Quantity selector for add-on choices. Example: add matching accessories.
Price matrix
Row and column pricing table. Example: size by quantity range pricing.
Field setup
Sell related products with the Product Bundle field
The Product Bundle Add-On field adds selected WooCommerce products or variations as real linked cart rows. Use it for accessories, optional upgrades, starter kits, replacement parts, or products sold at a special bundle price.
- Add a new field inside a Global Group or a product-level add-on group.
- Enter a customer-facing field label, then choose Product Bundle Add-On as the field type.
- Use Products / Variations to search for every item the customer may add.
- Choose how the options appear: Checkboxes, Radio buttons, Select dropdown, or Card layout.
- Choose a Price mode and enter the price or discount value when that mode needs one.
- Choose a Quantity mode. Enter a fixed quantity when using Fixed quantity.
- Choose how unavailable products should be handled with Stock behavior.
- Enable Required when the customer must choose a bundle item, then save the group or update the product.
Bundle display and pricing controls
Checkboxes or cards
Customers can select multiple bundle products. Cards include the product image, name, calculated bundle price, and stock state.
Radio or select
Customers choose one bundle product. Use radio buttons for visible comparison or a select dropdown for a compact layout.
Same or override price
Use the WooCommerce product price automatically, or replace it with the exact bundle item price you enter.
Discount or free
Subtract a fixed amount, apply a percentage discount, or include the selected bundle item at no charge.
Quantity and stock behavior
- Fixed quantity: every selection adds the quantity configured by the store owner.
- Same as parent: the bundle quantity follows the main product quantity and stays synchronized when the cart quantity changes.
- User selectable: the customer chooses the quantity for each selected bundle item.
- Stock handling: respect stock normally, hide out-of-stock choices, or display unavailable choices in a disabled state.
Example: Build a laptop accessory bundle
Add a mouse, laptop sleeve, and USB-C dock. Use the Card layout, allow multiple selections, apply a 10% bundle discount, and keep each accessory quantity synchronized with the laptop quantity.
Bundle selections are real WooCommerce cart items, so WooCommerce can retain their product or variation identity, stock behavior, quantity, price, and order line details. Do not select the main product itself as one of its own bundle items.
Field setup
Collect a separate recipient or delivery address
The Address field keeps a complete address together inside one add-on field. It is useful when the product should be sent to a gift recipient, event venue, installation address, or another destination that differs from the WooCommerce billing and shipping address.
- Add a new field and enter a clear label such as Gift recipient address or Installation address.
- Choose Address field as the field type.
- Add optional Description / help text explaining when this address will be used.
- Place the help text above or below the inputs, or display it as a tooltip.
- Enable Required when the customer must complete the entire address.
- Optionally enable field pricing when collecting the address should add a fixed delivery or handling fee.
- Save the group and test the address on a matching product page.
Recipient name
The person or business receiving the product.
Street address
The full street and building address, displayed across the wider row.
City and state
Separate locality and state/province inputs with browser address autocomplete support.
ZIP and country
Dedicated postal code and country inputs complete the destination.
Example: Send a gift to another person
Create a Gift delivery group with Recipient address, Delivery date, and Gift note fields. Mark the address as required and assign the group only to gift products.
When Required is enabled, all six address inputs must be completed. The formatted address travels through AJAX add-to-cart, cart, checkout, order details, WooCommerce emails, and the admin order editor.
Field setup
Require approval or agreement before purchase
The Terms / consent checkbox is an acceptance field for proof approvals, personalized-order terms, production confirmations, or no-refund agreements. It can include a direct link to a page or document the customer should review.
- Add a new field and use a precise label such as Artwork proof approval.
- Choose Terms / consent checkbox as the field type.
- Enter the Text before link, for example I have reviewed and accept the.
- Enter the Linked text, for example final artwork proof or custom order terms.
- Paste the full Link URL for the terms, policy, or proof document.
- Choose whether the link should open in a new browser tab.
- Save the group and test both an accepted and an unaccepted add-to-cart request.
- Always required: the field cannot be converted into an optional consent, and pricing controls are intentionally unavailable.
- Safe link: the URL is sanitized before it is saved and can open with secure new-tab attributes.
- AJAX protected: server-side validation blocks normal and AJAX add-to-cart requests until the exact acceptance value is submitted.
- Order record: accepted consent appears with the field label in cart, checkout, order metadata, and the WooCommerce admin order editor.
- Translation ready: the field label, statement, and linked text can be registered with WPML or Polylang.
Example: Approve personalized artwork
Use the label Final proof approval, enter I approve the as the text, link final artwork proof to the proof document, and place the field after the file upload or customization choices.
Use a field label that identifies what was accepted. The field records acceptance with the WooCommerce order, but your store should still use terms and policies appropriate for its legal requirements.
Reference
Pricing modes
Enable pricing on a field when the customer choice should change the product price.
Free option
No extra charge. Example: choose a free color.
Fixed fee
Add one fixed amount. Example: gift wrap +$5.
Quantity based fee
Add a fixed price for the selected quantity. Example: extra item quantity.
Percentage fee
Add a percentage of the base product price. Example: insurance +10%.
Per character fee
Charge by character count. Example: engraving at $0.20 per character.
Per word fee
Charge by word count. Example: custom printed message per word.
Per file fee
Charge when a file is attached. Example: artwork setup fee.
Per area fee
Multiply the rate by area or volume. Example: width x height x $2.
Range based fee
Use a configured value as the field price. Example: setup fee for a selected range.
Negative fee / discount
Subtract an amount. Example: pickup discount -$3.
For choice fields, option prices can also be added per option, such as Small free, Large +$10, XL +$18.
Backup and migration
Import / Export add-on setups
The Import / Export tab helps agencies, store owners, and staging/live workflows move complete add-on setups between WordPress sites. Use JSON for real backup and restore work, and CSV when you want a readable review file for clients, teammates, or spreadsheet audits.
Full JSON backup
Use Download JSON Backup to export global groups, product-specific groups, plugin settings, and design settings in one portable file. This is the best option before changing a live store or moving from staging to production.
CSV review export
Use Download CSV Review when you need a spreadsheet-friendly audit of groups, fields, field types, required status, pricing mode, price, conditions, and product/category assignments.
Restore from backup
Upload a JSON backup, preview it, choose the import sections and import mode, then run the import. The plugin will report what was imported, updated, skipped, missing, or remapped.
Image swatch handling
Image swatch URLs are preserved by default. You can also choose to download remote image swatches into the local WordPress Media Library and remap the imported image URLs.
Export scopes
Full backup
Exports plugin settings, global add-on groups, product-specific add-ons, and design settings in one JSON file.
All global groups
Exports every reusable global group, including group details, assignments, fields, prices, defaults, conditions, measurements, and swatch URLs.
Selected global groups
Choose only the global groups you want to move or share with another site.
Product-specific add-ons
Exports add-ons saved directly inside one product editor, useful for duplicating a custom product setup.
Only plugin settings
Exports enabled status, frontend position, separate line item mode, pricing labels, and stylesheet settings.
Only design settings
Exports Design tab styling values and label-related design configuration.
Import modes
Merge with existing data
Add imported groups to the current setup while keeping existing groups.
Replace existing groups/settings
Replace the selected import sections with the data from the backup. Use this for full restore workflows.
Import as new copy
Create imported groups as new copies, useful when testing or duplicating a setup without overwriting existing groups.
Skip duplicates
Skip groups that appear to already exist by matching group names or internal IDs.
Update matching groups
Update existing matching groups instead of creating new copies.
Import preview and validation
Always click Preview Import before running an import. The preview shows the number of groups, fields, product-specific add-on sets, image URLs, missing products, missing categories, and possible conflicts.
- Duplicate detection: warns about matching group names, field labels, and internal field IDs.
- Product mapping: checks whether product-specific add-ons can be matched to a local product by ID or slug.
- Category mapping: checks whether imported category assignments exist on the local site.
- Missing target handling: choose whether to keep original product/category IDs or skip missing assignments.
- Image URL report: counts image swatch URLs found in the backup before import.
Recommended workflows
- Before editing a live site: choose Full backup and download a JSON file.
- Moving staging to live: export Full backup from staging, upload it on live, preview it, then use Replace existing groups/settings if the live site should match staging.
- Sharing only a template group: choose Selected global groups, export the group, then import it as a new copy on the target site.
- Duplicating one custom product setup: choose Product-specific add-ons for one product, then import on the target site and check the product mapping preview.
- Client review: download the CSV review file and share it as a spreadsheet before launch.
JSON is the correct format for backup, restore, and migration. CSV is for review only and should not be used as a restore file.
Manual orders
Add product add-ons inside WooCommerce orders
- Go to WooCommerce > Orders and create or edit an order.
- Add a product line item to the order.
- Open the Add-ons panel under that product line item.
- Select or enter the required add-on values.
- Click Save items so add-on prices update the line item total.
- Click Update order to save the order.
Admin-selected add-ons are stored as order item meta, so they can appear in order details, customer account pages, and WooCommerce emails.
Design and compatibility
Style, translate, and customize
Design tab
Use Ultimate Addons > Design to style the frontend wrapper, groups, labels, descriptions, inputs, choices, color swatches, image swatches, measurement fields, pricing rows, and grand total. The preview stays sticky while you scroll.
Custom CSS mode
In General settings, you can disable the plugin frontend stylesheet when you want to build the design completely from your theme, ACSS, or custom CSS.
WPML and Polylang
The plugin registers customer-facing strings for popular translation plugins, including group labels, field labels, options, measurement labels, pricing labels, cart details, and order meta.
Conditional logic
Use conditional logic to show fields only when other fields match a value, contain text, are filled, are empty, or match number rules. Use all-rules or any-rule matching.