# Marketing Suite - user guide

Seasonal email campaigns, brand voice, SEO tips, WooCommerce reviews/orders audiences, and the in-app tutorial for Descrybe v2.

## Start the tutorial (1 click)

1. Sign in and open **Dashboard**.
2. Click **Start tutorial** (welcome card or header).
3. Follow the highlighted controls — you must perform each action (no free Continue on action steps).
4. Use **Resume tutorial** after Pause, or **Restart tutorial** after Skip / Done.

Full step list: [tutorial.md](tutorial.md).

## Black Friday campaign in 5 clicks

Assumes you already have products in the catalog (map a feed or import first).

1. Open **`/campaigns`** → Create campaign  
   (or **`/marketing/calendar`** → Prepare Black Friday, then open Campaigns).
2. Pick the **Black Friday** season template.
3. Choose categories/products (or leave defaults for top catalog items). Optionally set audience to purchasers after syncing Woo orders.
4. Click **Generate** (template mode is free; AI generate needs Starter+ / credits -- Free returns 402).
5. **Send test** to yourself, then **Schedule** or **Send** once your email provider is verified under **`/integrations/email`**.

### Optional: Content Calendar one-shot

**`/marketing/calendar` → Prepare Black Friday** creates a seasonal export-feed bundle for the BF window. Then open **`/campaigns`** to draft the email.

## Free vs paid

| Action | Free | Paid (Starter+) |
|--------|------|-----------------|
| Create campaign drafts, pick seasons | Yes | Yes |
| Template generate (no AI) | Yes | Yes |
| AI campaign / SEO / brand AI | No (`can_use_ai=false`, 0 monthly credits) | Yes (credits / BYOK) |
| Real email blast | Dry-run until upgrade + verified provider | Verified Resend/SMTP |
| Brand kit form | Yes | Yes |
| SEO recommendations (template fill) | Yes | AI fill on paid |
| Woo orders/reviews sync | Yes (connection required) | Yes |

Details: [free-tier.md](free-tier.md). Upgrade from **Pricing** / **Plans** when you hit an AI or send gate.

## Brand kit

**`/brand`** (nav: Marketing → Brand kit) — tone, do/don't, colors, preferred terms, logo URL, and **logo file upload** (`POST /api/brand/logo`). Product AI and campaign AI inject this voice when AI is enabled.

## SEO

**`/seo`** (nav: Marketing → SEO) — missing meta, thin/duplicate titles, weak images. Template apply on Free; AI fill on paid.

## Orders, reviews and purchase audiences

1. Connect the store under **`/woocommerce`** (Connection tab).
2. Open the **Orders** tab → **Sync orders** (worker pulls Woo REST orders into `woo_orders` / `woo_order_items`).
3. Open **Reviews** (`/woocommerce?tab=reviews`; nav `/reviews` redirects here) → **Sync reviews**.
4. In a campaign (`/campaigns`), choose a purchase-based audience. On send, campaigns call `ResolveAudience` against synced orders.

API: `POST /api/woocommerce/sync-orders`, `sync-reviews`; `GET /api/woocommerce/orders`, `reviews`; `POST /api/woocommerce/audience`.

## Email provider

**`/integrations/email`** (nav: Email sending) — Resend or SMTP, verify from-address/domain, then send tests. Free plans force dry-run for real blasts. See [email-sending.md](email-sending.md).

## Related docs

- [QA local demo](qa-local-demo.md) — login, Local Demo Co, uploads, nav status  
- [Demo user](demo-user.md) — credentials + company counts  
- [Marketing suite design](marketing-suite-design.md)  
- [Free tier gates](free-tier.md)  
- [Email sending](email-sending.md)