Renamed from Referally

Every name that changed when Referally became Referalli, what still works under the old name, and when the old names go away.

Embed
Preview of the card
<a href="https://referalli.com/docs/renamed-from-referally"><img src="https://referalli.com/docs/_api/public/orgs/07f432f4-34b9-46a7-aaad-c0e395d2e4f9/spaces/2bf4f614-3630-4fbf-85f9-5ecafa6b7d97/pages/ddb20551-3924-47d3-a94b-5c1e12c891ff/social-card.svg?v=3e7ae33eec8b" alt="Renamed from Referally" width="600" height="315"></a>

Referally became Referalli in October 2026. Every name you can see as an integrator was renamed. The old names still work, so nothing broke on the day of the rename. Read the new name and fall back to the old one until the date in the last column.

Where

Old name

New name

Until

Attribution cookie and localStorage key, written by the tracking script and the kits

referally_ctx

referalli_ctx

The script writes both, with the same value and expiry, until 2027-01-31. From then on it writes only referalli_ctx.

API request headers

Referally-Version, Referally-Mode

Referalli-Version, Referalli-Mode

Old names accepted until further notice.

Webhook headers

x-referally-*

x-referalli-*

Old names are still sent, with identical values, until further notice.

Billing metadata on your customer

referally_customer_ref

referalli_customer_ref

Old key read as an alias until further notice.

Risk verdict metadata (auth platforms)

referally_risk

referalli_risk

Old key read as an alias until further notice.

Embeds

<referally-signup>, <referally-referral-widget>, <referally-widget-referrer>, --referally-* CSS properties

<referalli-signup>, <referalli-referral-widget>, <referalli-widget-referrer>, --referalli-*

Old tags and properties still registered until further notice.

Domain verification TXT record

_referally-verify.<domain>

_referalli-verify.<domain>

Old record accepted until further notice.

Dashboard sign-in cookie

referally_session

referalli_session

Moved to the new name automatically at your next request.

Not renamed: the HubSpot properties Referalli writes (referally_partner_id, referally_partner_status, referally_referrals, referally_lifetime_commission, referally_commission_currency). Renaming them would leave the data already in your CRM under the old properties, so they keep their names.

Read referalli_ctx first and fall back to referally_ctx. Do it before 2027-01-31, or your code stops finding a referral once only the new name is written. The SDK's referralFromCookieHeader already does this, so use it instead of parsing the cookie by hand:

import { referralFromCookieHeader } from 'referalli';

// Express: req.headers.cookie. Next.js: (await headers()).get('cookie').
const referral = referralFromCookieHeader(req.headers.cookie); // { anonId, clickId, code } | null

When a visitor withdraws consent, clear both names: the cookie and the localStorage key.

When an old name goes away

Every removal is announced in the changelog at least 90 days ahead, with its date. The first one is the referally_ctx cookie twin, on 2027-01-31.

Updated