Skip to content
English
  • There are no suggestions because the search field is empty.

How do I buildout a Mail Landing Page?

How to build the page a mailer's QR code opens, on the client's promo branch.

A Mail LP (Direct Mail landing page) is the page a mailer's QR code opens. It shows the mailer's specials, the direct mail tracking number, a Book Now button, reviews, hours and the map, in the client's brand.

The QR code on the mailer points at dmredirects.com/<slug>, a redirect the Direct Mail team sets up. At first it forwards to the Dashboard's page. We build the client's own page and, once it's live and checked, point the redirect at it. Mailers never need to be reprinted.

How it's built

  • Repository: the client's GitHub repository (named for their domain), on a long-lived branch called promo. If the client's website is already in GitHub, it's the same repository; if not, a new one is made from the website template.
  • Same data as the website: the promo branch uses the same practice.ts file as the website, so fixes can move between the website and the Mail LP.
  • Hosting: its own Cloudflare project, promo-<domain-with-dashes> (for example promo-smilesdental-com), building the promo branch.
  • URL: promo-<client>.dentist-near-me.com (for example promo-smilesdental.dentist-near-me.com). Not <client>.dentist-near-me.com, which is for One Page LPs.
  • Multi-location clients: the slug is <client>-<location>, and each location gets its own branch (promo-<location>), Cloudflare project and URL (promo-<client>-<location>.dentist-near-me.com) in the same repository.
  • Never indexed: every page is noindex and robots.txt blocks everything. Patients only reach it from the QR code.

Dashboard Mail LPs are different. This SOP is for tickets whose Creative Buildout Request Type is Direct Mail LP - Repo. Tickets marked Direct Mail - Dashboard LP are still built in the Dashboard.

Before you start

  1. Open the ticket in the Internal - Creative Buildouts pipeline and check it has:
    • Mailer Final Creative File: the approved mailer PDF.
    • Mail LP URL Domain Name: the dmredirects.com link. Its last part is the slug.
  2. Scan or open the dmredirects.com link. If it doesn't exist yet, ask the Direct Mail team to create it. Don't create redirects yourself.
  3. Check the HubSpot company has:
    • Call Tracking - Direct Mail LP: the tracking number every call button will use.
    • A Google Place ID, Business Hours and a Booking Link.
    • Mailer Reviews, if the client chose any.
    If the tracking number is missing, ask the Onboarding Lead/Specialist.
  4. Check the client's Google Drive folder for photos to use before any stock.

Option A: With Claude

Who can use this: the /mail-lp command only works for people with access to the Creative team's buildouts repository (creative-team-assets). Everyone else: use Option B or ask the Creative team.

  1. Open Claude Code in the buildouts folder of creative-team-assets and run the command below with the ticket link.
  2. Setup: Claude does a dry run first and tells you what it will create: the repository and promo branch, the Cloudflare project, the URL and the BugHerd project. It then creates them and fills in the ticket and company fields:
    • Ticket: BugHerd Link, GitHub Repository, Staging Link and Digital Marketing URL.
    • Company: Mail LP URL.
  3. Content: Claude reads the mailer PDF, the HubSpot company, Google (hours and reviews) and the client's website (logo, colors, fonts, booking link). It shows you a summary. Check it against the mailer before you say OK:
    • Specials, word for word.
    • Phone, hours and booking link.
    • Reviews and brand.
  4. Preview: Claude builds the page, checks it (no template text, every call button uses the tracking number, noindex) and gives you a local preview link with desktop and mobile screenshots. Ask for any changes.
  5. Go live: say go only when the preview is right. Claude publishes the page and checks the live URL.
  6. QR code: before Claude points the dmredirects.com link at the new page, tell the Direct Mail team (client and slug). Claude then repoints it and follows the QR link to confirm it opens the page.
  7. QA: Claude creates the HubSpot QA task for the Content & UX QA owner.
/mail-lp [HubSpot ticket link]

If anything in the summary or preview is wrong or missing (a special, a phone number, a photo), tell Claude in plain words. Don't guess: anything nobody can answer goes in the handoff document for the Creative Lead.

Option B: Without Claude

Use this when you don't have access to the buildouts repository or Claude isn't available. You need access to GitHub, Cloudflare, BugHerd and HubSpot. Ask the Creative Lead for anything you can't open.

1. Set up the page

  1. Repository: open the client's GitHub repository. If they have none, ask the Creative Lead to create one from the website template.
  2. Branch: create a promo branch from development (multi-location: promo-<location>). If promo already exists, use it.
  3. Cloudflare: create a Worker named promo-<domain-with-dashes>, connected to the repository and building the promo branch.
    • Add these variables:
      • PUBLIC_PROMO_AS_INDEX = true
      • PUBLIC_PHONE_VARIANT = mailLanding
      • PUBLIC_SITE_URL = the LP URL
      • PUBLIC_BUGHERD_KEY = the BugHerd project key (until launch)
    • Add the custom domain promo-<client>.dentist-near-me.com.
  4. BugHerd: create the project for the LP URL and copy its share link (not the /projects/ link).
  5. HubSpot fields:
    • Ticket: BugHerd Link (share link), GitHub Repository, Staging Link (LP URL) and Digital Marketing URL (the dmredirects.com link).
    • Company: Mail LP URL (the dmredirects.com link).

2. Add the content

Edit src/data/practice.ts on the promo branch.

  • Specials (promoSpecials): copy each special from the mailer word for word: name, price, description and fine print. Leave the expiration date out; the page shows a rolling 7-day expiry.
  • Phone:
    • Every phone slot (main, googleAds, mailLanding) is the company's Call Tracking - Direct Mail LP number.
    • Only practicePhone keeps the practice's real number.
    • The number printed on the mailer is different on purpose.
  • Hours: the company's Business Hours. If empty, use the Google Business Profile and add them to HubSpot.
  • Booking link: the company's Booking Link. If empty, copy the link of the Book or Schedule button on the client's website and add it to HubSpot.
  • Reviews:
    • 5 to 10 in all: the company's Mailer Reviews plus 4 and 5-star Google reviews.
    • Names as first name + last initial (Katie C.).
    • Not website testimonials: the review cards show a Google logo.
  • Google: the Place ID, Google profile link, write-a-review link and map from the company's address.
  • promoHero: the mailer's headline, a short tagline with the offers, and a people or family photo (images/promo-hero.jpg).
  • promoMeta:
    • Title: New Patient Specials | <Practice> in <City>, <ST>
    • Description: about 150 characters naming the offers, practice and city.

Then the brand:

  • Logo (light and white versions), favicon and a 1200×630 share image (images/og.jpg) in public/.
  • The client's colors and fonts at the top of src/styles/global.css.
  • Match the mailer where it differs from the website.

3. Check it

Push the promo branch. Once the Cloudflare build succeeds, open the LP URL on desktop and on your phone and check:

  • No template text anywhere (Sample Dental, (555), Anytown, Lorem).
  • Every call button shows the Direct Mail LP tracking number.
  • The specials match the mailer word for word.
  • The headline, buttons and rating show without scrolling.
  • Book Now, the map, hours and the support pages work.
  • The page is noindex.

If the first deploy shows a placeholder page, run the build again.

4. Point the QR code at it

  1. Tell the Direct Mail team which client and slug you're about to repoint. Never repoint a dmredirects.com link without telling them first.
  2. In redirect.pizza, edit the existing dmredirects.com/<slug> redirect so its destination is the LP URL, as a temporary (302) redirect. Don't create new redirects.
  3. Scan the mailer's QR code with your phone and confirm it opens the new page.

5. Send it to QA

Create a HubSpot task for the Content & UX QA owner:

  • Title: QA Direct Mail LP: <Practice>.
  • Due the next working day, associated to the ticket and the company.
  • Include the LP link, the BugHerd share link and the mailer link.

They follow How do I perform a Content & UX QA for Mail LP?

Wrap up

  • After QA:
    • Fix the BugHerd items.
    • Soft launch: move the ticket to Ready To Share.
    • Launch, once the client approves:
      • Remove the BugHerd sidebar (clear PUBLIC_BUGHERD_KEY and redeploy).
      • Confirm the QR code still opens the LP.
      • Replace the ticket's old Dashboard Mail LP URL with the dmredirects.com link.
      • Close the ticket.
      With Claude, the Creative Lead runs both steps.
  • Never take anything down: leave the Dashboard page and any older promo page live. Some printed mailers link to them directly.
  • Code fixes made on the promo branch go back to the website template (development, then staging, then main). Never straight to main.
  • If the Direct Mail team asks for a link: the only one they need is the dmredirects.com link on the QR code.
  • Update the ticket with what's live and what's left, and for whom.