# Last Chance User Guide

Welcome to the Last Chance documentation! This guide will help you get the most out of your unsubscribe page management platform.

## What is Last Chance?

Last Chance is an email retention platform that transforms your unsubscribe pages from dead-ends into opportunities. Instead of losing subscribers forever, you can:

- **Offer alternatives** - Let subscribers pause emails or adjust preferences
- **Incentivize staying** - Display discount codes and special offers
- **Understand why they leave** - Collect feedback with customizable reason forms
- **Match your brand** - Build beautiful pages with our visual editor
- **Track everything** - Monitor retention rates and subscriber behavior

## Documentation Overview

### 📖 [Getting Started](./getting-started.md)

Complete setup guide covering:

- Initial setup wizard and Klaviyo connection
- Creating your first unsubscribe page
- Using the visual editor and settings
- Segment experiences and smart-offer rules (personalized HTML per subscriber context)
- Adding discount codes
- Publishing your page
- Setting up Klaviyo unsubscribe hosted page for automatic redirects

**Best for**: New users setting up Last Chance for the first time

---

### 👤 [Subscriber Experience](./subscriber-experience.md)

See what your subscribers experience when they click unsubscribe:

- Understanding the unsubscribe journey
- All page states (Initial, Stayed, Unsubscribed, Paused, Resubscribed)
- Personalized experiences when segment experiences and smart-offer rules are enabled
- Features available to subscribers
- Best practices for designing effective pages
- Understanding retention impact

**Best for**: Users wanting to understand what subscribers see and optimize the experience

---

### 📊 [Analytics](./analytics.md)

Learn how to use analytics to improve retention:

- Understanding key metrics and event types
- Using filters and search
- Analyzing unsubscribe reasons
- Exporting data for further analysis
- Best practices for data-driven decisions

**Best for**: Users wanting to understand and improve their retention rates

---

### 🩺 [Retention Health](./retention-health.md)

See how your Klaviyo setup scores against retention best practices:

- Overall health score and what it means
- Flows (sunset, win-back, post-pause, reward delivery)
- Topic and frequency exclusion segments
- Primary page published and quick actions

**Best for**: Teams with Klaviyo connected who want a guided checklist beyond page analytics

---

### 🎯 [Churn intelligence](./churn-intelligence.md)

Use Last Chance + Klaviyo data to spot at-risk subscribers, sync profile properties, and create **segments** and **draft flows** for retention campaigns.

- Scheduled and manual profile sync
- Pre-built segment definitions (with Klaviyo engagement where used)
- Starter flows you finish in Klaviyo

**Best for**: Paid teams with Klaviyo (and ideally Shopify) who want actionable churn segments without building definitions from scratch

---

### 👥 [Team Management](./team-management.md)

Collaborate with your team effectively:

- Understanding Admin and Member roles
- Inviting team members
- Managing pending invitations
- Removing team members
- Security best practices

**Best for**: Admins managing team access and collaboration

---

### 💳 [Billing & Account](./billing-account.md)

Manage your subscription and account:

- Understanding pricing tiers
- Managing your subscription
- Handling tier changes
- Using the billing portal
- FAQ and troubleshooting

**Best for**: Admins managing billing and subscription

---

### 🌐 [Branded Unsubscribe Subdomain](./branded-unsubscribe-subdomain.md)

Serve your public unsubscribe page on a dedicated subdomain with clean URLs:

- Choosing a slug on the Account page (Scale plan and above; custom domain on Advanced+)
- How Klaviyo hosted page and preview use your branded URL
- Clean `/unsub` addresses without `email` or `teamId` after validation
- Security recommendation (Klaviyo ID validation)
- Local testing with `*.localhost` and troubleshooting

**Best for**: Paid teams that want branded unsubscribe links and a cleaner subscriber URL

---

### ⚙️ [Klaviyo Unsubscribe Hosted Page Setup](./klaviyo-hosted-page-setup.md)

Complete guide to setting up Klaviyo **unsubscribe** hosted pages:

- Understanding how unsubscribe hosted pages work
- Step-by-step setup process
- How the redirect flow works
- Troubleshooting common issues
- Reverting to default behavior

**Best for**: Users setting up automatic unsubscribe redirects from Klaviyo

---

### 📧 [Klaviyo unsubscribe and preference links in emails](./klaviyo-email-links-and-consent-pages.md)

How to add **unsubscribe** and **manage preferences** links in Klaviyo templates (`{% unsubscribe %}`, `{% unsubscribe_link %}`, `{% manage_preferences %}`, `{% manage_preferences_link %}`), how that ties to **consent pages** and your Last Chance **hosted pages**, plus links to Klaviyo Help Center articles.

**Best for**: Anyone wiring Last Chance who needs correct tags in campaigns and flows

---

### ⚙️ [Klaviyo Preference Center Setup](./klaviyo-preference-center-setup.md)

Recommended second hosted page so **manage preferences** links open your Last Chance **preferences** screen (`data-entry="preferences"`) for full email coverage.

**Best for**: Teams that want preference-center traffic in Last Chance as well as unsubscribes

---

### 📧 [User Preferences](./user-preferences.md)

Complete guide to the email preferences feature:

- How subscribers customize their email experience
- Setting up frequency and topic options
- Configuring preferences pages
- Analytics and tracking
- Best practices for implementation

**Best for**: Users wanting to offer subscribers more control over their email experience

---

## Articles and strategy guides

Longer reads on the marketing site: [yourlastchance.app/articles](https://www.yourlastchance.app/articles)

- [Email unsubscribe rate benchmarks](https://www.yourlastchance.app/articles/email-unsubscribe-rate-benchmarks) — **unsubscribe rate** and **average unsubscribe rate** in context
- [Pause subscription vs unsubscribe](https://www.yourlastchance.app/articles/pause-subscription-vs-unsubscribe) — **pause subscription** and list health
- [Klaviyo unsubscribe link guide](https://www.yourlastchance.app/articles/klaviyo-unsubscribe-link-guide) — **Klaviyo unsubscribe link** flow and Last Chance

Use these alongside the Klaviyo setup guides ([hosted page](./klaviyo-hosted-page-setup.md), [email links](./klaviyo-email-links-and-consent-pages.md), [preference center](./klaviyo-preference-center-setup.md)).

---

### ⚙️ [Settings](./settings.md)

Comprehensive guide to all settings pages:

- User Preferences settings (frequency, topics, pause durations)
- Team Pause Settings configuration
- Reward Delivery settings
- Discount Codes management
- Email Provider settings
- System Segments management

**Best for**: Admins configuring account settings and preferences

---

### 🔑 [API Keys](./api-keys.md)

Authenticate scripts, automation, and MCP hosts with team API keys:

- Creating and revoking keys in Account Settings
- Scopes (`pages:read`, `pages:write`, `pages:publish`, `pages:ai`, `team:read`, `analytics:summary:read`, `analytics:attribution:read`)
- Hosted MCP at `https://www.yourlastchance.app/mcp`
- Example `curl` requests for pages, team context, and Klaviyo lists
- Delete confirmation, errors, and security best practices

**Best for**: Admins wiring CI, automation, or Claude/Cursor MCP against Last Chance APIs

---

## Quick Start Checklist

New to Last Chance? Here's the fastest path to your first live unsubscribe page:

- [ ] **Sign up** and complete the initial setup wizard
- [ ] **Connect Klaviyo** to sync your subscriber data
- [ ] **Create a page** from the Unsubscribe Pages section
- [ ] **Customize** using the visual editor or settings panel
- [ ] **Add a discount code** (optional but recommended)
- [ ] **Publish** your page to make it live
- [ ] **Set up Klaviyo unsubscribe hosted page** to automatically redirect to your new page
- [ ] **Monitor analytics** to track your retention rate

## Feature Highlights

### Visual Page Editor

Build stunning unsubscribe pages without coding:

- Drag-and-drop components
- Custom CSS support
- Responsive design preview
- Real-time preview

### Smart Integrations

Connect with your existing tools:

- **Klaviyo** - Unsubscribe hosted page setup and subscriber syncing
- **Discount codes** - Create and display offers to retain subscribers
- **Analytics** - Track every interaction and reason

### Subscriber Options

Give subscribers choices beyond unsubscribe:

- **Stay Subscribed** - Quick confirmation to remain on the list
- **Manage Preferences** - Customize email frequency and topics
- **Pause Emails** - Temporarily stop emails for 1 week to 3 months
- **Unsubscribe** - Clean exit with optional feedback

### Team Collaboration

Work together effectively:

- Unlimited team members on all plans
- Role-based access control
- Shared pages and analytics

---

## Getting Help

### Self-Service Resources

- **This documentation** - Comprehensive guides for all features
- **In-app help** - Tooltips and contextual guidance
- **Setup checklist** - Track your progress in the page editor

### Contact Support

- **Email**: support@yourlastchance.app

### Common Issues

| Issue                 | Solution                                               |
| --------------------- | ------------------------------------------------------ |
| Can't connect Klaviyo | Re-authorize from Settings → Email Providers           |
| Page not showing      | Verify page is published and links are updated         |
| Discount not working  | Create matching code in your e-commerce platform       |
| Analytics empty       | Allow time for events; check page is receiving traffic |

---

## What's New

Stay updated with the latest features and improvements:

- **User Preferences** - Let subscribers customize email frequency and topics
- **Settings Pages** - Comprehensive configuration for preferences, pause settings, and more
- **Visual Editor** - New GrapesJS-powered drag-and-drop editor
- **Pause Options** - Let subscribers take a break instead of leaving
- **Enhanced Analytics** - Filter by campaign, flow, and more
- **Billing** - Automatic tier management based on profile count

---

## Feedback

We're always improving! Send feedback to feedback@lastchanceemail.com or use the in-app feedback option.

---

<div align="center">

**Ready to get started?** → [Getting Started Guide](./getting-started.md)

</div>
