Promote
Recommend your accepted offers with a page, a widget, tracking links or magic links.
There are four ways to put your offers in front of readers. Open Promote in the sidebar to find all of them.
Every reader passes the same quality checks and 14 days of screening before they count, whichever way they arrive.
| Method | Best for |
|---|---|
| Recommendations page | A link in your newsletter or on your site. No code. |
| Widget | Recommending right after someone joins your own newsletter. |
| Tracking links | Promoting one offer in an issue. |
| Magic links | Links in your emails that pre-fill the reader's address. |
Recommendations page
A public page that lists your offers. Letterby shows each visitor up to 4 of them and skips offers that do not target the visitor's country.
Open Promote, then Recommendations page, and copy the Public link.
Share it in your newsletter, welcome email or site.
Readers pick the newsletters they want and enter their email once. They are subscribed to all of them at once.
One-tap link for emails
Copy the One-tap link and replace the placeholder with your provider's merge tag for the reader's email. The reader then subscribes with one tap.
| Provider | Merge tag |
|---|---|
| Beehiiv | {{ email }} |
| Kit | {{ subscriber.email_address }} |
Widget
A pop-up shown on your site right after someone joins your newsletter. It suggests up to 5 of your offers, and the reader subscribes to them in one step.
Open Promote, then Widget, and select Copy snippet.
Paste the script tag into your site.
Call trigger from your subscribe form's success handler, with the email that just signed up:
window.Letterby?.trigger({
creatorSlug: "your-publication-handle",
email: subscriberEmail,
});| Option | Required | Meaning |
|---|---|---|
creatorSlug | Yes | Your publication handle. The copied snippet fills it in. |
email | Yes | The address that just signed up. |
theme | No | "light", "dark" or "auto". Follows the visitor's system setting by default. |
Call window.Letterby.close() to close the pop-up yourself. Select Preview widget in the console to see it.
The widget shows nothing when you have no offers for that reader.
Tracking links
One link per accepted offer. Open Promote, then Tracking links, and copy the link. Open an offer under Creator, then Offers, for snippets and a QR code.
A reader who follows the link lands on a subscribe page for that newsletter and enters their email.
A tracking link stops working when the offer or your agreement is no longer active.
Magic links
A tracking link that pre-fills the reader's email. Open Promote, then Magic links, copy the link and replace the placeholder with your provider's merge tag, as in the table above.
The reader still selects Subscribe.
What readers see
They enter their email, or it is already filled in.
They are added to the advertiser's list right away. No confirmation email is sent.
They select the button and are added to the advertiser's list.
Tips
- Recommend offers that match what your readers care about. Readers who do not open the advertiser's emails are not paid.
- Do not send signups from your own team's addresses or devices. Letterby blocks self-referrals and can suspend the publication.
- Pause or end a promotion from the offer's page when you no longer want to run it.