# Settings Guide

## Overview

The Settings section provides comprehensive configuration options for your Last Chance account. This guide covers all available settings pages and their configurations.

## Settings Pages

### User Preferences

Configure how subscribers can customize their email experience.

#### Frequency Configs

Manage email frequency options that subscribers can choose from.

**Location:** Settings → User Preferences → Frequencies tab

**Features:**

- Add/edit/delete frequency options
- Set number of days for each frequency
- Reorder options by dragging
- Enable/disable specific options
- Initialize default options

**Default Options:**

- Weekly (7 days)
- Monthly (30 days)

**Usage:**
Frequency configs are used in the preferences page to let subscribers choose how often they want to receive emails. These values are stored in Klaviyo as the `email_frequency` profile property.

#### Topic Configs

Manage email topic options that subscribers can choose from.

**Location:** Settings → User Preferences → Topics tab

**Features:**

- Add/edit/delete topic options
- Customize labels for each topic
- Reorder options by dragging
- Enable/disable specific options
- Initialize default options

**Default Options:**

- Promotions
- Newsletters
- Product Updates
- Education
- Events

**Usage:**
Topic configs are used in the preferences page to let subscribers choose which types of emails they want to receive. These values are stored in Klaviyo as the `email_topics` profile property (comma-separated).

#### Pause Duration Configs

Manage pause duration options for the pause emails feature.

**Location:** Settings → User Preferences → Pause Duration Configs

**Features:**

- Add/edit/delete pause duration options
- Set number of days for each duration
- Mark options as default
- Reorder options by dragging
- Enable/disable specific options

**Default Options:**

- 7 days
- 14 days
- 30 days
- 60 days
- 90 days

**Usage:**
Pause duration configs are used in the pause emails modal to let subscribers choose how long they want to pause emails.

#### Team Pause Settings

Configure how the pause emails feature works for your team.

**Location:** Settings → User Preferences → Team Pause Settings

**Features:**

- Select pause methods (can use multiple):
  - **Profile Property** - Sets a custom profile property in Klaviyo
  - **Suppression** - Suppresses the profile in Klaviyo (90-day cooldown)
  - **Unsubscribe** - Unsubscribes from lists or globally

**Pause Methods Explained:**

1. **Profile Property (PROFILE_PROPERTY)**
   - Sets `last_chance_pause_emails_until` property in Klaviyo
   - No cooldown restrictions
   - Most flexible option
   - Best for: Flexible pause functionality

2. **Suppression (SUPPRESSION)**
   - Suppresses the profile in Klaviyo
   - Enforces 90-day cooldown from last suppression date
   - Klaviyo-native functionality
   - Best for: Complete email suppression

3. **Unsubscribe (UNSUBSCRIBE)**
   - Unsubscribes from specific lists or globally
   - No cooldown restrictions
   - Best for: List-specific unsubscribes

#### Exclusion Segments (Klaviyo)

Topic, frequency, and pause exclusion segments are managed in User Preferences. Each tab has an **Email configs** section at the top and a **Segments** section below.

**Topic Exclusion Segments** (Settings → User Preferences → Topics tab → Segments)

- Create one segment per topic (e.g., `LC - Exclude Topic: Sales & Discounts`)
- **Usage:** Add the **matching** segment to "Don't send to"—use the one that corresponds to the type of email you're sending (e.g., for a newsletter campaign, add `LC - Exclude Topic: Newsletters`)
- Use any main segment for "Send to"

**Frequency Exclusion Segments** (Settings → User Preferences → Frequencies tab → Segments)

- Create one segment per frequency (e.g., `LC - Exclude Frequency: Weekly`)
- **Usage:** Add **every** LC - Exclude Frequency segment to "Don't send to" in each campaign and flow—you need all of them to enforce frequency limits across your audience

**Pause Exclusion Segments** (Settings → User Preferences → Pause tab)

- Single segment: `LC - Exclude: Paused`
- **Usage:** Add to "Don't send to" in all campaigns and flows to exclude paused subscribers

### Email Providers

#### Klaviyo Settings

Configure your Klaviyo integration.

**Location:** Settings → Email Providers → Klaviyo

**Features:**

- Connect/disconnect Klaviyo account
- View connection status
- Re-authorize if needed
- View API key status

### Reward Delivery

Configure how discount codes are delivered to subscribers.

**Location:** Settings → Reward Delivery

**Features:**

- Select reward delivery mode:
  - **Immediate** - Discount code shown immediately on the page
  - **Delayed** - Discount code sent via email later

**Delivery Modes:**

1. **Immediate (IMMEDIATE)**
   - Discount code is displayed on the unsubscribe page
   - Subscriber can copy and use immediately
   - Best for: Instant gratification, higher conversion

2. **Delayed (DELAYED)**
   - Discount code is sent via email after the subscriber stays
   - Creates anticipation and follow-up opportunity
   - Best for: Email engagement, reducing code sharing

**Usage:**
The selected delivery mode affects which elements are shown on your unsubscribe page templates. Elements with `data-reward-mode="immediate"` are shown for immediate delivery, and elements with `data-reward-mode="delayed"` are shown for delayed delivery.

### Discount Codes

Manage discount codes for your unsubscribe pages.

**Location:** Settings → Discount Codes

**Features:**

- Create new discount codes
- Edit existing discount codes
- Delete discount codes
- View code usage statistics
- Set codes as active/inactive

**Discount Code Types:**

1. **Shopify Discount Codes**
   - Automatically synced from Shopify
   - Can be used in Shopify checkout
   - Requires Shopify integration

2. **Manual Discount Codes**
   - Created manually in Last Chance
   - Can be used with any e-commerce platform
   - Requires manual setup in your platform

**Best Practices:**

- Create multiple codes for A/B testing
- Use descriptive names for easy identification
- Set expiration dates to encourage urgency
- Monitor usage to optimize discount amounts

## Best Practices

### 1. Start with Defaults

- Initialize default configs when first setting up
- Customize based on your specific needs
- Test with a small group before rolling out

### 2. Keep Options Manageable

- Limit frequency options to 3-5 choices
- Limit topic options to 5-7 choices
- Too many options can overwhelm subscribers

### 3. Use Clear Labels

- Use descriptive, action-oriented labels
- Avoid technical jargon
- Make it clear what each option means

### 4. Test Pause Methods

- Start with PROFILE_PROPERTY for flexibility
- Add SUPPRESSION if you need Klaviyo-native suppression
- Use UNSUBSCRIBE for list-specific control

### 5. Monitor Usage

- Check analytics to see which options are most popular
- Adjust configs based on subscriber behavior
- Remove unused options to simplify

## Troubleshooting

### Configs Not Showing

- Ensure configs are initialized (use the initialize action)
- Check that configs are enabled (`isActive: true`)
- Verify you're viewing the correct team

### Segments Not Creating

- Create segments from Settings → User Preferences → Topics or Frequencies tab → Segments section
- Check Klaviyo connection status (Settings → Email Providers → Klaviyo)
- Verify API permissions in Klaviyo
- Review error logs for API issues

### Pause Not Working

- Verify pause methods are enabled in team settings
- Check Klaviyo profile properties are being set
- Review pause duration configs are active

## Related Documentation

- [User Preferences](./user-preferences.md) - How subscribers use preferences
- [Getting Started](./getting-started.md) - Initial setup guide
- [Analytics](./analytics.md) - Track settings usage