> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmailr.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Mailr is a direct-mail marketing platform for US home-services contractors. Each postcard is personalized with an AI-enhanced image of the recipient's own home and a unique QR code that leads to a personalized landing page. Campaigns can target a neighborhood the customer draws on a map, the homes around past jobs they upload or import, or fire automatically from their CRM. Mailr does not mail an uploaded recipient list. When answering questions, prefer the exact steps and UI labels from these docs, and direct users to app.getmailr.com to sign in. For anything involving account-specific data, billing disputes, or mail that appears lost, direct the user to support@getmailr.com.
# How Mailr works
> Mailr mails postcards personalized with the recipient's own home and a unique QR code, then tracks every scan and lead back to the card that produced it.
Mailr turns a mailing list into a stack of one-of-a-kind postcards, then follows each one until it
produces a lead. This page explains the whole loop in plain language: what goes on the card, what
happens when someone scans it, the three ways to run a campaign, and how credits are charged.
## What makes a Mailr postcard different
Every card is built for one household. Mailr's AI creates an enhanced image of the recipient's own
home, then composites it with your branding, the recipient's mailing address, and a unique QR code
printed just for that card. Two neighbors on the same campaign get two different postcards.
The look and content come from two places you control:
* Your **brand kit** — your logo library, colors, company details, industries, and showcase photos.
Every design and landing page pulls from it automatically. See [Brand kit](/designs/brand-kit).
* A **design** — a reusable postcard design, front and back, built from your brand kit. You approve
a design before it can mail. See [Postcard designs](/designs/overview).
## From mailbox to lead
A **landing page** is the web page a homeowner lands on after scanning the QR code on their
postcard, and it's personalized to their address. Because each card carries its own QR code, Mailr
knows exactly which postcard produced each scan and each form submission — that's what lets you tie
a lead back to a specific campaign and address instead of guessing.
```mermaid theme={null}
flowchart LR
A[Personalized postcard] --> B[Homeowner scans the QR code]
B --> C[Personalized landing page]
C --> D[Lead captured in Mailr]
D --> E[Sent to your CRM]
```
Scans and leads show up in your Tracking dashboard as they happen. If you've connected a CRM, leads
flow into it and closed deals can be traced back to the mailer that started them — what Mailr calls
**attributed revenue**. See [Tracking dashboard](/results/dashboard) and
[Attribution](/results/attribution).
## Three ways to run a campaign
A **campaign** is one batch of postcards: who gets mailed, which design, and which landing page.
Each household on a campaign is a **recipient**. There are three ways to build one:
1. **A neighborhood you choose.** Draw an area on the map, filter the homes inside it, and mail it
once — good for a seasonal push or a specific neighborhood you already have in mind.
2. **Neighborhoods around your jobs.** Target the homes surrounding jobs you've completed — brought
in from your CRM or a simple list of job addresses — so the neighbors see the work you just did.
3. **CRM-triggered automations.** An **automation** is a rule that starts a campaign automatically
from activity in your CRM — for example, when a job is marked complete. See
[Automations](/campaigns/automations) and [Targeting](/campaigns/targeting).
Mailr always skips your **suppression list** — the addresses and past customers you've marked
do-not-mail. See [Opt-outs and suppression](/campaigns/opt-outs-and-suppression).
## How credits work
**Credits** are your prepaid balance for mailing. Submitting a campaign **holds** credits for the
postcards in it; mail **settles** those holds as cards actually go out; anything not used comes back
to your balance. As the product puts it: "Submitting a campaign holds credits — mail settles them",
"Unused holds are always released back", and "You see the exact cost before anything mails". You can
"Explore everything before adding a dollar — nothing ever charges automatically." Full detail lives
in [Credits and pricing](/billing/credits-and-pricing).
New workspaces get a small allowance of **free preview renders** — trial credits for generating
personalized images before you fund mail credits, so you can see real output first. Your remaining
count is shown on the dashboard checklist.
## Nothing mails without your approval
"You approve every design before it can mail." Designs sit in your hands until you approve them, and
a campaign shows you its cost before you submit it. See
[Create a design](/designs/create-a-design) and [Create a campaign](/campaigns/create-a-campaign).
Mailr mails within the United States only.
## Next steps
The end-to-end path, start to finish.
Create your workspace and let Mailr read your website.
Every Mailr term, defined in one place.
Turn on automatic campaigns and revenue tracking.