> ## 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.
# Brand kit
> Build your Mailr brand kit from your website or a brand guidelines PDF, then fine-tune colors, logos, company details, and showcase photos.
Your **brand kit** is your logo library, colors, company details, industries, and showcase photos. Every postcard design and landing page pulls from it automatically. Find it at **Designs → Brand kit**; old `/brand-setup` links redirect here. **Save changes** sits in the page header and stays disabled until something changes.
## Import your brand in one click
Enter your site in the **WEBSITE** field (for example `yourcompany.com`) and press **✦ Generate from website**. Mailr reads the site and fills in colors, logos, company details, and showcase photos, showing a progress line for each piece — such as **"Importing colors & logos from your website…"** — that ends in **"Imported …"** or an error with a **Retry** link.
Switch to the **▤ Brand guidelines PDF** tab and use the **Drop a brand guidelines PDF** zone. The limit is **PDF · max 50 MB**. There's an optional **WEBSITE (OPTIONAL — COMBINED WITH THE PDF)** field: fill it in and Mailr merges both sources. The button reads **✦ Generate from PDF** or **✦ Generate from PDF + website**. Reading a PDF takes about a minute.
### Replace or Augment
The **MODE** radio applies to both tabs:
* **Replace existing data** — *"Overwrites company details, colors, logos, and showcase photos with what we find."*
* **Augment existing data** — *"Only fills empty fields and adds new colors and photos — nothing is removed."*
Use **Augment** once you've made edits by hand; use **Replace** when you've rebranded or the first import got it wrong.
After an import you'll see a summary line and a **↻ Refresh from website** link, plus a strip reading **"Not yet confirmed — review the details below, then save to confirm your brand kit."** Nothing is confirmed until you save.
## Company details
*"These may appear verbatim on your designs."* Four fields: **Company name** (required to save), **Website**, **Location** (your city — the placeholder reads `e.g. Austin`), and **Phone number**, which auto-formats when you tab out.
That's the whole list. There is no license-number field, no street-address field, no offer-text field, and no email field on the Brand kit.
## Industry
*"Up to four. They drive template matching."* Use **＋ Add** to pick chips; a counter shows **"N of 4 selected"**, with **Clear** and **Done**. Your picks decide which postcard designs Mailr matches you to.
## Colors
*"Drag to reorder — the top color is your primary. Edit the value, name, or role for any color."*
Each row has a drag handle, a swatch, an eyedropper, a hex field, a name field, and a **Role** dropdown: **Primary**, **Secondary**, **Accent**, or **Neutral**. Only one color can be Primary and one Secondary; setting a role reorders the list. **＋ Add color** adds a row. The eyedropper samples a color out of one of your logos — with no logo uploaded it's disabled and reads *"Upload a logo to pick colors from it."*
## Logos
*"Your logo library. The default logo is used for new designs."* Four slots: **Default logo**, **Secondary logo**, **Dark logo**, and **Mascot / symbol**. Use **＋ Upload logo** or the **＋ Add logo** tile, which asks **"WHICH LOGO IS THIS?"**
Every non-default slot has a **×** to remove it and a **Make default** button that swaps it with the current default. After an upload, Mailr may offer a background-removed version as a one-click swap — handy when your logo came off your site with a white box behind it.
## Landing page browser tab
*"How your public QR-scan page shows up in the browser tab."*
* **Tab title** — max 80 characters, defaults to your company name. *"Shown as the browser-tab title when someone scans your QR code."*
* **Favicon** — **Upload**, **Replace**, or **Remove**. *"Square images work best."* Accepted formats are PNG, JPG, WEBP, and SVG. `.ico` and `.gif` files are rejected.
## Showcase images
**Showcase images** are photos of your past work that Mailr can pull from when designing postcards and landing pages.
Photos found on your website are pre-selected: *"click to include or exclude, then save."* Each tile toggles between **Included — click to exclude** and **Excluded — click to include**. **＋ Add image** uploads your own, several at a time. The limit is **60 images**; past it you'll see *"Showcase is capped at 60 images — N were left out."*
## Google reviews
*"Import your Google reviews for your landing pages."* Pick your business from the candidate list — each shows a name, address, rating, review count, and sometimes a **Matches your site** badge — then press **Import reviews**. The status runs from **"Import queued…"** through **"Importing your Google reviews — this takes a minute or two…"** to **"N reviews imported — manage them in Landing pages."** If it fails, import them later from [Landing pages](/results/landing-pages). **×** dismisses the card.
## Save
The bottom bar shows **UNSAVED CHANGES** or **BRAND KIT READY** with a summary of your company details, colors, logos, and showcase images. Press **Save and continue →** to save and move on to the [design templates gallery](/designs/templates), or **Save changes** in the header to stay put.
## Reset brand kit
**Reset brand kit**, at the very bottom of the page, clears your company details, colors, logos, and showcase photos. The confirmation says *"This can't be undone."* There is no undo — you'd re-import from your website or rebuild by hand.
## Troubleshooting
The banner reads **"We couldn't read your website — build your brand kit below."** The site may be blocked, unusual, or the URL wrong. Re-enter the address and press **✦ Generate from website**, upload a brand guidelines PDF instead, or fill the fields in by hand.
You'll see **"No usable photos on your website — add your own."** Upload job photos under **Showcase images** with **＋ Add image**.
You went over the limit and some photos were left out. Exclude or remove weaker ones and keep your best work.
The message reads **"That PDF is X MB — the maximum is 50 MB."** Compress or split the PDF, then upload again.
An import ran but hasn't been saved. Review the sections below the strip, then press **Save changes** or **Save and continue →**.
**Company name** under **Company details** is blank. Fill it in and save again.
## Next steps
Match a postcard design to your new brand kit.
Where imported reviews and your tab title show up.