Letterby Docs

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.

MethodBest for
Recommendations pageA link in your newsletter or on your site. No code.
WidgetRecommending right after someone joins your own newsletter.
Tracking linksPromoting one offer in an issue.
Magic linksLinks 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.

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.

ProviderMerge 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,
});
OptionRequiredMeaning
creatorSlugYesYour publication handle. The copied snippet fills it in.
emailYesThe address that just signed up.
themeNo"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.

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.

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.

On this page