Skip to content
AdvocateLoop Docs

WordPress Plugin Settings Reference

This page is a reference for every setting in the plugin’s admin pages, and a guide to where each kind of configuration lives — the WordPress plugin settings, or the AdvocateLoop dashboard.

Where settings live

The plugin keeps most configuration in the AdvocateLoop dashboard so that changes take effect immediately across every site connected to your brand (without needing to update each WordPress install).

A handful of settings are local to WordPress because they only make sense in a WordPress context (which credential to use, whether debug mode is on, WooCommerce-specific toggles).

Where to configureWhat’s configured there
WordPress admin (this plugin)API credentials, WooCommerce on/off, debug mode, thank-you-page widget toggle
AdvocateLoop dashboardDiscount type and value, reward type and value, attribution window, widget appearance, widget messaging, custom URL parameters, customer-facing message templates, notification settings, domains list

If you can’t find a setting in the WordPress admin, it’s almost always in the dashboard.

Plugin settings (WordPress admin)

Located at AdvocateLoop in the main sidebar, or WooCommerce → AdvocateLoop if you’re running WooCommerce.

Connection tab

SettingDescriptionDefault
API KeyYour AdvocateLoop API key. Found in your dashboard at Settings → API Keys. Treated as a credential — kept server-side, never sent to the browser.Required
Brand IDYour brand’s unique identifier (UUID). Found alongside the API key in the dashboard.Required
Connection statusA live check that the credentials work. Re-runs whenever you save changes. Green = connected, red = a problem the error message will describe.—

WooCommerce tab

This tab only appears if WooCommerce is installed and active.

SettingDescriptionDefault
Enable WooCommerce integrationMaster switch for the WooCommerce-specific features (auto-apply, claim and conversion tracking, in-checkout messaging). Turning this off leaves the base WordPress plugin running but disables everything tied to WooCommerce.On
Show share widget on thank-you pageIf on, the share widget appears on the order-received page after a successful (non-referred) purchase. Lets customers immediately become advocates. Turning this off leaves the page untouched.On
Debug modeEnables extra logging for troubleshooting. See Using debug mode for details.Off

Settings managed in the AdvocateLoop dashboard

These don’t live in WordPress — they live in your dashboard at app.advocateloop.com. They’re listed here so you know where to look.

Configure → Rewards

  • Customer discount — what referred customers receive (e.g., 15% off, or $10 off)
  • Advocate reward — what advocates earn per successful referral
  • Minimum purchase amount — the cart subtotal needed for the discount to apply
  • Maximum discount amount — caps the discount at a fixed value, even on larger carts
  • First-purchase only — restricts the discount to customers without a prior order
  • Attribution window — how long a referral link stays valid after the first click (default: 30 days)

Configure → Widget

  • Headline, description, button text — the copy shown in the widget
  • Success messages — what appears after a customer claims a discount or signs up as an advocate
  • Checkout applied message — what appears in the WooCommerce checkout when a referral discount is auto-applied
  • Widget appearance — colors, fonts, position

Configure → Tracking

  • URL parameters — what URL parameters the plugin recognizes as referral codes (defaults: ?ref=, ?referral=, ?adv=, ?advocate=). You can add your own custom parameter.

Configure → Notifications

  • Email templates and triggers for advocate signup, referral success, reward earned, etc.

Admin → Domains

  • The list of domains authorized to load the widget. Your WordPress site’s domain must be in this list for the widget to render.