Rekomi Docs
For brandsInstall tracking
Brands

Install on WordPress

The Rekomi plugin is the one-click path, with or without WooCommerce. WPCode stays documented as the no-plugin alternative.

The modern WordPress install is the Rekomi plugin: install it from the plugin directory, click Connect, and tracking is live. It works two ways depending on your site:

  • WooCommerce store: full native tracking. Every order attributes automatically on every gateway, affiliates get real store coupons, renewals and refunds are handled, and the whole program is managed from the Rekomi page in wp-admin. See Install on WooCommerce.
  • Any other WordPress site (memberships, courses, SaaS marketing sites): the plugin installs the Rekomi tracking snippet for you, so referral links track first-party while your connected billing platform (Stripe, Paddle, and others) records the sales.

Install the plugin

  1. Plugins > Add New > search "Rekomi" > Install Now > Activate.
  2. Open Rekomi in the admin sidebar and click Connect to Rekomi.
  3. Sign in or create your account and approve the connection.

Done. No code, no theme edits, and the install survives theme switches and updates because nothing lives in your theme.

The no-plugin alternative: WPCode

Prefer not to add a plugin that connects to a service? The snippet also installs by hand with the free WPCode plugin (formerly Insert Headers and Footers), the maintained standard for code injection. Block themes (default since 2022) hide the Theme File Editor, and direct theme edits break when you switch themes, so WPCode's site-wide Header field is the right place.

WPCode > Code Snippets > Header & Footer. In the Header box, paste:

<!-- Rekomi tracking -->
<script async src="https://api.rekomi.com/api/v1/r/loader.js" data-program-id="YOUR_PROGRAM_ID"></script>
<noscript>
  <img src="https://api.rekomi.com/api/v1/r/c.gif" width="1" height="1" alt="" />
</noscript>

Save Changes. Copy the snippet with your program ID already filled in from Setup > Install in Rekomi.

Cache plugins require a purge. WP Rocket, W3 Total Cache, LiteSpeed Cache, and WP Super Cache serve previously-rendered HTML until you purge, so the fresh script tag will not appear until cache regenerates. After purging, hard-refresh and View Source to confirm the Rekomi script tag is in the <head>.

WooCommerce stores: use the plugin

With the Rekomi plugin, WooCommerce sales record natively: order-level attribution on every gateway (including the WooCommerce Stripe gateway and cash on delivery), affiliate coupons minted as real WooCommerce coupons, WooCommerce Subscriptions renewals as recurring commissions, and line-level refund clawbacks. The head-script-plus-S2S relay that this page used to describe is no longer necessary for WooCommerce; the plugin does all of it without code. Full details: Install on WooCommerce.

Other WordPress billing plugins

MemberPress, Paid Memberships Pro, LearnDash, Easy Digital Downloads, and most membership/course plugins bill through a payment gateway rather than WooCommerce. If the plugin creates real Stripe subscriptions with Stripe invoices on your connected account, those sales can ride the Stripe rail (attribution still needs a redeemed coupon, a recorded lead, or stamped metadata; see Install on Stripe). Otherwise relay the plugin's order-complete hook to the S2S endpoint, passing window.Rekomi.getReferral() through checkout as the referral.

The tracking script integrates with the WP Consent API: when a consent-management plugin is active, tracking waits for the marketing-consent signal and loads on opt-in. Without one, it loads normally. The decision runs client-side, so page caches cannot freeze a stale consent state into your HTML.

Troubleshooting

Script tag does not appear in View Source. Your cache plugin is serving stale HTML; purge it. With the Rekomi plugin, also check the Rekomi page shows Connected (the script only serves while the connection is active).

Clicks register but conversions do not. On a non-WooCommerce site the script only captures the click; the sale is recorded by your connected billing platform or your S2S relay. Confirm the affiliate's coupon was redeemed on the billing side, or that your relay is firing.