Product documentation

FluentCart Product Add-Ons Documentation

Install the plugin, activate your license, create global add-on groups, build product-specific groups, move setups between sites with import/export, and configure every supported field type.

Install the Plugin

  1. Download the plugin ZIP file from your BricksUltimate account or the product download link.
  2. Go to WordPress admin, then Plugins, Add New, Upload Plugin.
  3. Select the plugin ZIP file and click Install Now.
  4. Click Activate Plugin after WordPress finishes the installation.
  5. Make sure FluentCart is installed and active because this plugin adds product add-on features to FluentCart products.

Activate the License Key

  1. Go to FluentCart, Product Addons.
  2. Open the License tab.
  3. Paste your license key in the license field.
  4. Click Activate License.
  5. Wait for the success message. The plugin stores the license key securely and saves the license status for future checks.
  6. After activation, return to General or Add Global Group to save settings and groups.

Importing product add-on data requires an active license. Export and preview tools remain available so you can review backups safely.

Create a Global Add-On Group

  1. Go to FluentCart, Product Addons, Add Global Group.
  2. Click Add Group.
  3. Enter the Group Name and optional Description.
  4. Enable or disable Display name and Display description based on how you want the group to appear on the product page.
  5. Choose whether the group applies by category or product.
  6. Add fields inside the group and configure each field.
  7. Drag groups, fields, and options to reorder them.
  8. Click Save Groups.

Global groups are reusable. Use them for common upgrades like gift wrap, priority handling, size upgrades, file uploads, measurement pricing, or subscription add-ons.

Create an Independent Product Group

  1. Open a FluentCart product in the product edit screen.
  2. Find the Product Addons section below the inventory area.
  3. Add a new add-on group for this product.
  4. Add and configure fields the same way you configure global groups.
  5. Save or update the product.

Product-specific add-on groups override global add-ons for that product. Use this when one product needs its own custom fields, pricing, choices, or measurement rules.

Common Field Settings

Label and Description

Set the field title, customer-facing description, placeholder, and help text position. Help text can also appear as a tooltip.

Required Fields

Enable Required when the customer must complete the field before adding the product to the cart.

Pricing Option

Enable pricing for input-based fields, then choose the pricing mode and price or rate value.

Conditional Logic

Show a field only when another option is selected. Add one or more conditions and choose AND or OR logic between rules.

Field Type Setup Guide

Text Input

Use for short custom text like initials, names, engraving text, or labels. Configure label, placeholder, help text, required status, and pricing options.

Textarea

Use for longer notes, instructions, messages, or custom requests. Supports help text, placeholder, required status, per character fee, and per word fee.

Checkbox

Use for one or multiple selectable options. Add option name, price, default state, and allow multiple selections when needed.

Radio Buttons

Use when the customer must choose one option from a list. Add option labels, option prices, and a default selected option.

Select Dropdown

Use for compact option lists. Add placeholder text, option labels, option prices, defaults, and enable multi-select when required.

Number Input

Use for quantity-like values, custom counts, or numeric customer input. Configure placeholder, help text, required state, fixed fee, percentage fee, or custom pricing modes.

Measurement / Area Pricing

Use for products priced by width, height, or length. Set unit label, formula, enabled dimensions, labels, min, max, and step values. The frontend calculates the add-on amount from the configured rate and submitted dimensions.

Image Swatches

Use for visual choices like colors, styles, materials, or patterns. Add option label, price, image URL, or choose an image from the WordPress media library.

File Upload

Use when customers need to provide artwork, documents, references, or upload-related add-ons. Configure help text and per file pricing when applicable.

HTML Section Block

Use to display custom HTML content between fields. Best for notices, layout breaks, embedded instructions, or trust messages.

Heading / Paragraph

Use to add non-input content such as section headings, explanations, preparation steps, or grouped instructions.

Pricing Modes

Free

No extra charge is added for the field or selected option.

Fixed Fee

Adds a fixed amount to the product or add-on total.

Percentage Fee

Calculates the add-on charge from the product base price.

Negative Fee / Discount

Subtracts an amount from the calculated total for discount-style add-ons.

Per Character Fee

Useful for engraving, printed text, custom labels, and personalization.

Per Word Fee

Useful for message cards, writing services, instructions, or printed copy.

Per File Fee

Adds a charge based on the number of uploaded files.

Measurement Rate

Measurement fields calculate pricing from the configured rate and selected area or volume formula.

Display Add-Ons in Cart, Checkout, and Orders

  1. Open FluentCart, Product Addons, General.
  2. Keep Globally Enable Product Add-Ons turned on.
  3. Choose the product page position for add-on fields.
  4. Enable the pricing box if you want to show original price, add-ons total, and grand total on the product page.
  5. Enable separate cart line items if selected add-ons should appear as their own linked add-on line in cart, checkout, and order records.

Selected add-ons are saved with the cart item and order item so store admins can review selections during fulfillment, receipts, emails, invoices, and order views.

Import / Export Add-On Setups

Use Import / Export to back up your Product Add-Ons setup, move add-on groups between sites, review add-on data in a spreadsheet, or restore a previous configuration.


What Can Be Exported

Choose Full backup, Global groups only, Product-specific groups only, or Settings only. A full backup includes plugin settings, global groups, and product-specific groups.

Available Export Files

Download a JSON backup when you want to restore or move data. Download a CSV review file when you want a spreadsheet-friendly overview of groups, fields, options, and pricing.

License Requirement

Export and preview are available for review and backup. Running an import requires an active license because it writes add-on data into the store.

Import Preview

Always use Preview Import before Run Import. The preview shows counts for global groups, product groups, settings, duplicate group names, and possible issues.


Export a Backup


  1. Go to FluentCart, Product Addons.
  2. Open the Import / Export tab.
  3. In Export Backup, choose the export scope.
  4. Choose Full backup when you want the safest complete backup before making major changes.
  5. Click Download JSON Backup to create a portable restore file.
  6. Click Download CSV Review if you only need a readable spreadsheet-style file for auditing or client review.

Import or Restore a Backup


  1. Open FluentCart, Product Addons, Import / Export.
  2. In Import / Restore, choose a JSON backup file exported from FluentCart Product Add-Ons.
  3. Select the sections you want to import: Global groups, Product-specific groups, Plugin settings, or any combination of them.
  4. Choose the import mode that matches your goal.
  5. Choose how missing product or category targets should be handled.
  6. Enable Download remote image swatches if the backup includes image URLs that should be copied into the local WordPress Media Library.
  7. Click Preview Import first and review the report.
  8. If the report looks correct and your license is active, click Run Import.

Import Sections


Global Groups

Imports reusable groups managed from the Add Global Group tab. These groups can include assignment rules, fields, options, pricing, images, and conditional logic.

Product-Specific Groups

Imports groups saved directly on individual FluentCart products. The importer tries to match products on the destination site before saving these groups.

Plugin Settings

Imports General settings such as global enable state, frontend stylesheet preference, product add-ons position, custom selector, pricing box labels, and separate line item behavior.

Selective Restore

Uncheck sections you do not want to change. For example, import only Settings, or import only Global groups without touching product-specific groups.


Import Modes


Merge with Existing Data

Adds imported groups to the current setup. Use this when you want to add groups without removing what already exists.

Merge and Skip Duplicate Group Names

Adds new groups but skips imported global groups when a group with the same name already exists.

Update Matching Group Names

Replaces matching global groups by name and updates matching product-specific records. Use this when syncing a known setup from staging to production.

Import as New Copies

Imports groups as copies, regenerates field IDs where needed, and adds an Imported label to copied global group names.

Replace Imported Sections

Replaces the selected imported sections. Use with care, and export a full backup first.


Missing Product or Category Targets


Imported global groups may reference products or categories from the original site. If those targets do not exist on the destination site, choose one of these options:


  1. Keep original IDs: Keeps the saved IDs in the group. Use this when both sites share the same product/category IDs or you plan to fix assignments manually after import.
  2. Remove missing targets: Removes targets that cannot be matched locally. Use this when moving between different stores with different products or categories.

Image Swatch Imports


If your add-on options use image swatches, enable Download remote image swatches when importing from another site. The importer will copy remote image URLs into the destination WordPress Media Library when possible and update the imported option image URLs.


Recommended Workflow


  1. Export a Full backup before making large import changes.
  2. Upload the JSON backup on the destination site.
  3. Run Preview Import and review duplicates, missing targets, and section counts.
  4. Choose the safest import mode. For most migrations, start with Merge or Import as new copies.
  5. Run Import only after the preview looks correct.
  6. Open Add Global Group and a few product edit screens to confirm groups, assignments, option prices, and image swatches.
  7. Test one product on the frontend and add it to the cart to confirm pricing and order data.

Use JSON for backup and restore. CSV is intended for review only and is not used as an import source.