Addon Groups
Creating & Managing Addon Groups
Creating & managing addon groups: each group holds one or more fields, then you assign groups to products, categories, or all products globally.
Creating a group
- Go to Smart Add-Ons → Addon Groups → Add New Group.
- Enter a Group name (internal reference, not shown to customers).
- Enter a Display label (shown as the heading on the product page).
- Set the Layout: Stacked (fields one below the other) or Accordion (collapsible).
- Optionally set a Description that appears below the group heading on the storefront.
- Add fields using the Add Field button.
- Click Save Group.
Group settings
| Setting | Description |
|---|---|
| Group name | Internal name for identification in the admin. Not shown on the storefront. |
| Display label | Heading shown to customers above the group fields. Leave blank to show no heading. |
| Layout | Stacked: all fields visible. Accordion: group collapses; customer clicks to expand. |
| Description | Optional helper text below the group heading on the storefront. |
| Visibility — User role | Restrict the group to specific WooCommerce user roles (e.g., wholesale only). |
| Visibility — Date schedule | Show the group only between specified dates (e.g., holiday gift wrap). |
| Priority | Controls the order when multiple groups are assigned to the same product. Lower number = shown first. |
Assigning groups to products
After creating a group, scroll to the Assignment section:
- Specific products — search and select individual products. The group only appears on those products.
- Categories — select one or more product categories. The group appears on all products in those categories.
- Global — appears on all products site-wide.
You can also exclude a global or category group from specific products by going to the product edit screen and checking Exclude global addon groups, or listing excluded group IDs.
Duplicating a group
On the Smart Add-Ons → Addon Groups list, hover over a group and click Duplicate. A full copy of the group (including all fields, settings, and pricing) is created with a “(Copy)” suffix. Assignments are not copied.
Reordering fields
Inside the group editor, drag the ⠿ handle on the left of each field row to reorder. The order here matches the order shown on the product page.
Templates (save and reuse)
Save a group as a Template to reuse its field configuration across stores or projects:
- Open a group and click Save as Template.
- Give the template a name (e.g., “Gift Wrap – Standard”).
- When creating a new group, click Load Template and select the saved template.
Import & Export (JSON)
Export a group to JSON for backup or to transfer to another site:
- Export: Open a group, click the ⋮ More menu, and select Export as JSON. Save the file.
- Import: Go to Smart Add-Ons → Addon Groups → Import. Upload the JSON file. All fields, options, and settings are recreated. Assignments are not imported.
You can also import and export via the REST API: GET /saue/v1/addons/{id}/export and POST /saue/v1/addons/import. See the REST API reference.