Skip to content

How to let friends refer by name

Not every friend gets a link. Some hear about your store over coffee, see a post, or forget the code. With Refer by name, a new customer types the name of the friend who sent them, right in the cart. They get their welcome reward, and the referrer is credited when they order.

It works next to the referral link and code, not instead of them. A friend who arrives with a link never sees it.

  • Turn on Refer by name for a campaign.
  • Choose where the invitation shows: the cart page, the cart drawer, checkout, or several.
  • Check how many of your referrers can already be found by name, and help the rest add one.
  • Optionally, change the wording customers see.
Setting Starts as
Refer by name on a campaign you create On
Refer by name on a campaign that was already running when the feature arrived Off, until you turn it on
Show the invitation on Cart page and Cart drawer
Referrer names Copied from Shopify for referrers who have both a first and last name in their customer profile
Name fields when joining Shown in the referral popup and on the referral page while Refer by name is on
Text customers see Bloop’s default wording, translated into every language your campaign uses
  1. Open Link and code

    1. In your Shopify admin, click BLOOP Refer & Aff → Referral program, then open your campaign.

    2. In the Campaign setup list, click Sharing → Link and code (1).

    3. Find Refer by name (2) and turn it on:

      The Link and code page with Link and code (1) and the Refer by name setting (2) marked

    The three steps under the switch sum up the flow: Referrer adds their name, Friend types the name, Both get rewarded.

  2. Choose where the invitation shows → Click Save

    1. Under Show the invitation on, tick one or more places:

      Show the invitation on, with Cart page (1), Cart drawer (2), Checkout (3) and the line with Open checkout editor (4) marked

      Place What happens
      Cart page (1) A line appears above the checkout button on your cart page. No block to add
      Cart drawer (2) The same line appears above the checkout button in the slide-out cart, on any theme
      Checkout (3) Shopify Plus only. The invitation shows below the discount code field at checkout
    2. If you ticked Checkout, click Open checkout editor (4), add the BLOOP Refer by name block and save the checkout. Without the block, nothing shows at checkout.

    3. Click Preview next to Cart page or Cart drawer to open your store and see the invitation. Add a product to your cart first.

    4. Click Save in the bar at the top of the page.

  3. Check who can be found by name

    1. Below What customers see, read the count, such as 10 of 723 referrers in this campaign can be found by name.

    2. Click See who has no name (2) to open the campaign’s referrers, filtered to the ones still missing a name:

      What customers see, with Edit text (1), See who has no name (2) and the privacy note (3) marked

    Referrers without a name aren’t left out for long. They’re asked to add one in the referral popup and in their Referral Hub. You can also add a name for them. See Add or change a referrer’s name.

  4. Change the wording (optional)

    1. Under What customers see, click Edit text (1) next to the screen you want to change:

      Screen What it holds
      Popup: referrer joins The first and last name fields when someone joins
      Popup: after joining The name card and the message referrers send to friends
      Referral page The name fields and name card on your referral page
      Friend, in the cart The invitation link and the “Who referred you?” window
      Referral Hub The name card and the warning shown when a referrer changes their name
    2. The editor opens on that screen’s text. For Friend, in the cart, it opens Referral widget on Popup content (1), with the Refer by name section open (2) and the preview switched to Refer by name (3):

      The Referral widget editor with Popup content (1), the Refer by name text section (2) and the Refer by name preview (3) marked

    3. Change the text and click Save. Keep the placeholders, such as {{RefereeReward}}, {{ReferrerName}} and {{CartLink}}. Bloop fills them in for each customer.

When Refer by name is on, the referral popup and the referral page ask for a First name and Last name (1) next to the email when someone joins. A hint under the fields (2) says friends can type this name in the cart to get their reward, no link needed:

The referral popup with the First name and Last name fields (1) and the hint below them (2) marked

After joining, the popup shows a Tell friends your name card (1) with three short steps and a Copy message for friends button (2). The message reads like: “Get 10% off at your store! Add something to your cart, click “Enter their name” and type my name: Anna Lee.”

The popup after joining, with the Tell friends your name card (1) and Copy message for friends (2) marked

Referrers who joined before you turned the feature on and have no name see an Add your name so friends can find you card in the popup instead, with a Save my name button.

In the Referral Hub, referrers see Your referral name with their name (1), an Edit link (2) and the same copy button (3). Before they save a new name, the hub warns them that friends who know the old name need the new one. The same card is on the Referral Hub page in customer accounts.

The Your referral name card in the Referral Hub, with the name (1), Edit (2) and Copy message for friends (3) marked

  1. The friend adds something to their cart and clicks Enter their name (1) above the checkout button:

    The cart page with the Referred by a friend? Enter their name invitation (1) marked

  2. In Who referred you?, they type their friend’s full name (1) and click Find my friend (2):

    The Who referred you? window with the name field (1) and Find my friend (2) marked

  3. When Bloop finds one match, it shows who referred them (1). The friend enters their own email (2) and clicks Get my reward (3):

    The window after a match, with the referred you! title (1), the email field (2) and Get my reward (3) marked

  4. The discount goes into the cart, and the friend checks out as usual.

If two or more referrers share the name, or the friend only typed initials, Bloop asks for Your friend’s email to tell them apart. A wrong email shows That email doesn’t match the name you entered. The email only picks between people with that name: Bloop never finds a referrer by email alone.

The referrer is rewarded when the friend’s order goes through, exactly as with a link. The order shows the Refer by name channel in Analytics, and the friend’s claim shows as a Claimed entry in the activity log.

The invitation only shows to customers who arrived without a referral link and haven’t claimed a friend’s discount yet. Once they claim, it disappears. It doesn’t show if Refer by name is off, if no place is ticked, or for a cart or checkout place you didn’t pick.

Bloop looks for referrers in the same campaign whose first and last name match what the friend typed.

The friend types Result
anna nguyen, ANNA NGUYEN Found. Upper and lower case don’t matter
Anh Nguyen for “Ánh Nguyễn” Found. Accents don’t matter
Nguyen Anna Found. Word order doesn’t matter
Mrs Anna Nguyen Found. Titles such as Mr, Mrs, Ms, Miss, Dr and Prof are ignored
Anna, when only one referrer in the campaign is called Anna Found
A Nguyen, or a name two referrers share Bloop asks for the referrer’s email
Ana Nguyen (typo) or a nickname Not found. The friend can check the spelling and try again

Bloop also stops input that can’t be a name before it searches: an empty field, more than 100 characters or 6 words, two people at once (such as Anna and Tom), or something that looks like an email, a phone number or a referral code.

  • New customers only. The friend gets the same reward as through a link, under the same conditions, including any minimum order. Customers who have ordered before can’t claim it. See who can be referred.
  • No self-referral. A referrer can’t claim their own reward by typing their name.
  • One code per email. Claiming again with the same email gives the same code.
  • Names are letters only. Each part of a name is up to 50 characters, with no numbers, symbols or links. Hyphens and apostrophes, as in Mary-Jane O’Neil, are fine.
  • Searches are limited. Each visitor’s network can look up names up to 15 times an hour. This stops someone from guessing names to find referrers.
  • A new name replaces the old one. After a referrer or you change a name, only the new name works in the cart and at checkout.
  • Turning it off keeps names. When Refer by name is off, customers don’t see name fields, the name card or the invitation. Names already added are kept for when you turn it back on.
  • Deleted customers lose their name. When Shopify deletes or redacts a customer’s data, Bloop removes their referral name too.

Use this when a referrer asks you to fix their name, or to add one for a referrer friends can’t find yet.

  1. Open the referrer

    1. Open your campaign and choose Referrers on its Overview. Each referrer shows their referral name above the email, or No name yet (3).

    2. Click No referral name (1) to list only referrers without one. The line next to it (2) counts how many have a name:

      The campaign’s Referrers list with No referral name (1), the name count (2) and a No name yet badge (3) marked

    3. Click the referrer’s row.

  2. Edit the name → Click Save

    1. In Referral name (1), click Edit name (2), or Add name when there isn’t one yet:

      A contact page with the Referral name section (1) and Edit name (2) marked

    2. Enter the First name and Last name. If the referrer already had a name, the window warns that friends may know them by the old one (1):

      The Edit referral name window with the rename warning (1) marked

    3. Click Save. You’ll see Referral name saved.

    This changes only the name friends type in the cart. It doesn’t change the customer’s name in Shopify.

  • Turning it on with the app embed off. The cart page and cart drawer stay empty. Turn on the BLOOP app embed.
  • Ticking Checkout without the block. Add the Refer by name block in the checkout editor, or nothing shows at checkout.
  • Testing with a referral link open. The invitation is hidden for anyone who came through a link or already claimed. Test in a private window.
  • Forgetting your terms. Tell customers in your program terms that friends can find them by name.