Skip to content

How to customize the affiliate portal guide

The affiliate guide is a page inside the affiliate portal, under Guide in the menu. It’s your briefing for every partner: how to get their link, what they earn, when they’re paid and how to promote you. A clear guide gets partners to their first sale sooner and saves you answering the same questions by email.

  • A guide that matches what your program really offers
  • Your affiliate’s own commission rate, filled in automatically
  • Optional: images, such as product shots or a banner
  • A check of the guide in the live portal

Bloop starts you with a ready-made guide in four parts: Getting started, Commission structure, Promotion tips and Terms and conditions.

  1. Open the Affiliate guide

    1. In your Shopify admin, open BLOOP Refer & Aff → Affiliate program, then the Branding tab.

    2. On Affiliate guide, click Customize:

      The Branding tab (1) with Customize on Affiliate guide (2) marked

  2. Write your guide → Click Save

    1. Edit the text in Guide content. Use the toolbar for headings, lists, colors and links, or Source code to edit the HTML.

    2. Click Preview to read the guide as one page.

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

    4. Click Go to portal to open the guide in your live portal:

      The Affiliate guide editor with Guide content (1), Preview (2) and Go to portal (4) marked

Type {{commission_value}} anywhere in the guide, with two curly braces on each side, instead of typing the rate by hand: a typed rate goes out of date when you change a campaign. In the portal, each affiliate sees the rate of their own campaign:

Affiliate’s campaign {{commission_value}} shows
Basic, Percentage of sales The percent, for example 15%
Basic, Fix per order or Fix per item The amount in your currency, for example $10, with no “per order” or “per item”. Write that part yourself
Advanced The rate of the last level, which is the highest one
No campaign 10%, a fixed figure not tied to any campaign

Preview shows {{commission_value}} as typed. Only the live portal fills it in. It’s the only value the guide fills in: write your cookie window and payout schedule as plain text.

Add images by link. The upload option in the image dialog isn’t supported:

  1. In Shopify, go to Content → Files, upload your image and copy its link.

  2. In the editor, click the image button.

  3. Paste the link into Source.

  4. Click Save in the dialog, then Save the page:

    The image button (2), and the Insert/Edit Image dialog with Source (3) and Save (4) marked

Partners act on a guide that answers five questions: what they earn, when they’re paid, where their link is, how to promote you, and who to ask. Paste this into Source code, then replace everything in square brackets:

<h1>Welcome to the [Store name] partner program</h1>
<h2>What you earn</h2>
<p>You earn {{commission_value}} on every sale you refer. A sale counts if the customer buys within [30] days of clicking your link.</p>
<h2>When you get paid</h2>
<p>We pay commissions by [PayPal] every [month], once they're approved. Add your payment details under Settings so we can pay you.</p>
<h2>Get your link</h2>
<p>Your link is on your Dashboard. To link to one product, open Products and copy its affiliate link.</p>
<h2>How to promote us</h2>
<ul>
<li>[Show the product in use, with your honest opinion]</li>
<li>[Share your link in your bio, stories or newsletter]</li>
<li>[Please don't bid on our brand name in search ads]</li>
</ul>
<h2>Questions?</h2>
<p>Email us at [[email protected]].</p>

Keep promises to what you really do. If your payout runs when you approve it, say so rather than giving a fixed date.

The guide as affiliates see it in the portal

If a campaign has lifetime commission on, the affiliate’s campaign card also says what they earn on a referred customer’s later orders, and repeat orders carry a Repeat order badge on their Commissions page. Mention it in your guide so affiliates know to bring in customers who come back.

The guide is shown exactly as you write it, in one language. Portal translations only rename the Guide menu item. If your partners read different languages, write the guide in one they all understand, or put each language under its own heading.