Raptor Global Add-Ons – Upsells for WooCommerce

FAQ

How do I create a global add-on?

Go to Global Add-Ons > Add-Ons and click Add New Add-On (or Products > Add New and set the product type to Global Add-On). Add variations with prices, then click Manage Rules on the add-on to choose where it appears.

What’s the difference between a single add-on and a multi add-on?

A single add-on is one option at one price. Think of it as a simple yes/no extra, like Gift Wrapping $3. The customer either adds it or skips it.

A multi add-on gives the customer a choice between several options, each with its own price. For example, Gift Wrap with Standard $3, Premium $7, or Luxury $10.

Both use the same Global Add-On product type. To create a single add-on, set one price and leave the Variations tab empty. To create a multi add-on, add one or more variations with prices in the Variations tab.

Use single when you only need a yes/no extra. Use multi when customers benefit from choosing between tiers, styles, or levels.

Images: For single add-ons, upload the image using WooCommerce’s standard Featured Image box (top-right of the product editor). For multi add-ons, set an image on each variation inside the Variations tab. The image shows automatically on templates that display images (Choice Pills, Simple List, Option Cards, Modern List).

Can I assign add-ons to specific categories?

Yes. Free users can assign to all products, specific product categories, or guest users. Pro adds assignments to specific products, product tags, user roles, and individual users.

How do rule groups work?

Conditions inside a single group must all match (AND). If you add more groups, the add-on shows whenever any one group fully matches (OR).

For example: Group 1 = guest + Electronics category plus Group 2 = administrator role means the add-on shows to guests browsing Electronics, or to admins on any product.

Free supports a single group (AND). Multiple groups (OR logic) require Pro.

How do exclusions work?

Exclusions stop an add-on from appearing on specific products or categories, even when the assignment rules match. This is a Pro feature.

Can customers select multiple add-on options?

Yes. Each add-on can use either single selection (radio buttons) or multi-select (checkboxes). The Color Swatches and Modern List templates use a fixed selection mode.

Are add-on prices added to the product price?

Yes. The selected add-on price is added to the line total when the product is added to the cart, and shown clearly in the cart and checkout.

Does this work with variable products?

Yes. Global add-ons work with all WooCommerce product types that display a price: simple, variable, grouped, virtual, and downloadable.

Can I make an add-on required?

Add-ons are optional by default. If you need to enforce a selection, you can do so with custom code in your theme or a small snippet. Let us know and we can point you in the right direction.

Where do add-ons appear on the product page?

You can show add-ons before or after the Add to Cart button, after the product meta, after the short description, or after the full product content. Pick the position per add-on in the display settings when managing rules.

How do I change the order of add-ons?

Use the Sort Priority field on each add-on product. Lower numbers appear first. You can also change priority in bulk from the add-ons list.

How do Color Swatches work?

Color Swatches is a Pro template. Choose it as the display template, then set a Swatch Color on each variation (Variations tab). Variations without a color are hidden on the frontend on purpose. Color variants show even if they have no price.

How do tooltips work?

Tooltips are short notes that appear when a shopper hovers over an add-on option (or taps it on mobile). They help explain what an option is for without cluttering the page.

To add a tooltip:

1. Open the add-on product in the editor.
2. For a single add-on, fill in the Tooltip Text field.
3. For a multi add-on, expand a variation on the Variations tab and fill in the Description field.
4. Save.

A “?” icon appears next to the option on the product page. Hovering or tapping the icon reveals your tooltip. Tooltips work across all five display templates.

Tooltips are a Pro feature.

Can I customize how add-ons look?

Yes. Go to Global Add-Ons > Settings to set the primary color, price color, border style (sharp, rounded, or pill-shaped), and the label shown next to free add-ons.

Is there a limit on how many add-ons I can create?

No. Both the free and Pro versions let you create unlimited add-on products.

Can I import or export my add-on settings?

Yes. Global Add-Ons > Settings has an Import/Export section. Export your settings, add-ons, and rules as a JSON file for backup or to move to another site, then import it on the new site.

What happens if a customer doesn’t select an add-on?

Nothing. Add-ons are optional. The product can be added to the cart as usual, without any add-on selected.

How do I upgrade to Pro?

Visit the Pro checkout page: https://checkout.freemius.com/plugin/22559/plan/37780/

After purchase, you’ll receive a license key by email. Activate it from Global Add-Ons > Settings to unlock all Pro features instantly.

Is the plugin translation-ready?

Yes. All user-facing strings use WordPress’s translation functions. You can translate the plugin with Loco Translate, Poedit, or any other tool that works with .po / .mo files.

Does it work with WPML or Polylang?

Yes. Add-on assignments apply correctly on translated product pages. The plugin normalizes product IDs to the default language before checking rules.

Does it work with WooCommerce Subscriptions?

Yes. Add-on prices are applied to the initial subscription and are not double-counted on renewals, resubscribes, or plan switches.

Does it work with page builders (Elementor, Divi, Bricks, etc.)?

Yes. The add-on interface uses delegated event handlers, so it keeps working when a page builder re-renders the product form over AJAX.

Will it slow down my site?

No meaningful impact on your shoppers. Plugin styles and scripts only load on pages that actually show add-ons, and cart-related assets are skipped on the cart and checkout pages when no add-on items are present.

What happens when I deactivate or uninstall the plugin?

Deactivating the plugin stops add-ons from appearing on the frontend but keeps all your add-ons, rules, and settings in the database, so reactivating restores everything exactly as it was. Uninstalling the plugin removes the plugin files; to fully clean up your stored add-ons and rules, delete them from the admin before uninstalling.

Is any customer or order data sent to a third party?

No. Customer information, orders, and add-on content are never sent anywhere. The plugin does connect to a licensing service for activation and updates. See the External Services section below for the full picture.