Migrate from Solid Affiliate to Asteris Affiliates

Solid Affiliate to Asteris — what the import does

Solid Affiliate is built around the standard WordPress user model — every affiliate is a WP user with affiliate-specific meta. Asteris uses the same model, which makes the migration almost trivial: the WP-CLI importer reads Solid Affiliate's CSV export, matches each row to the existing WP user (no new user accounts created), and writes Asteris-equivalent meta plus referral rows. Existing affiliate logins keep working unchanged.

Run: wp asteris-aff import --source=solid-affiliate --csv=/path/to/solid-export.csv. The import:

• Affiliates: WP user ID (preserved as same affiliate ID), email, payout-method preference, default commission rate, status (active / inactive / pending). All preserved 1:1.
• Commissions (referrals): affiliate ID, related WC order ID, amount, currency, status. Status maps: Solid Affiliate "unpaid" → Asteris "unpaid", "paid" → "paid", "refunded" → "rejected".
• Per-product commission rates: Solid Affiliate ships per-product rates in core (one of its strengths). Asteris also ships per-product rates in core — the rates carry over per-product after import.
• Visit history: if Solid Affiliate's export includes visits (depends on plan), they're preserved row-by-row for the export window. Otherwise aggregate counts only.

The recommended cutover

1. Install Asteris alongside Solid Affiliate. No conflicts — separate tables.
2. Export from Solid Affiliate via Tools → Export.
3. Import via WP-CLI.
4. Verify 5–10 affiliates in Asteris admin.
5. Switch tracking: deactivate Solid Affiliate's tracking, leave plugin installed for 30 days.
6. Email affiliates their new vanity URL and dashboard. Legacy ?aff=... tracking parameter keeps working via the compatibility redirect.
7. After 30 days clean, deactivate Solid Affiliate and drop its tables.

Per-product commission rates — the Solid Affiliate-specific carry-over

Solid Affiliate is one of the few rival plugins that ships per-product commission rates in core (rather than as a paid add-on). If you've configured custom rates on specific WC products — for example, 25% commission on high-margin items and 5% on loss-leaders — those rates carry over to Asteris automatically via the importer.

The mechanics: Solid Affiliate stores per-product rates as WC product meta (_solid_affiliate_rate and similar keys). The Asteris importer reads each product's existing meta on import and writes the equivalent Asteris meta keys (_asteris_aff_rate) without touching the original Solid Affiliate keys. The result: both plugins see the rates after import, so if you're running the 30-day safety overlap, both systems credit commissions at the same rate.

Spot-check 3–5 products after import to confirm the rates carried correctly. Bulk-edit any that didn't via WP admin → Products → Quick Edit → Affiliate rate, or run wp asteris-aff product-rates set --product=123 --rate=25 via WP-CLI.

What changes day one

The moment you cut over to Asteris, you get the features Solid Affiliate doesn't ship: two-tier MLM referrals, AI swipe-copy generator, cloud-assist fraud detection, Stripe Connect direct payouts at 0.25%, PayPal API auto-batch, EDD adapter, Surecart adapter, vanity /go/{handle} landing pages, A/B email testing. The features Solid Affiliate ships well (per-product rates, clean WC integration) continue to work — Asteris matches or exceeds them, just inside a larger feature surface. Solid Affiliate vs Asteris full comparison →

If you're running EDD or Surecart in addition to WC

This is the most common reason Solid Affiliate customers migrate. Solid Affiliate doesn't track EDD or Surecart orders — your affiliate program only covers WC. Asteris's EDD adapter and Surecart adapter let one affiliate program cover all three carts with one admin, one portal, one payout flow. Set them up in Asteris Settings → Integrations after the WC import completes.

Migration assistance is included on Pro + Agency licences. Email [email protected] with your licence key.