> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.perkzilla.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Using Shortcodes in Campaigns & Emails

# Shortcodes for PerkZilla Campaign Editor & Emails

Personalize your campaign pages and emails dynamically using **Shortcodes**. These placeholders are automatically replaced with specific user data (such as their name, referral link, or point total) when they view your page or receive an email.

|| **Note:** Shortcodes are case-sensitive. Please ensure they are entered exactly as shown below.

---

## 📋 Available Shortcodes

Use the following shortcodes to insert dynamic content into your templates:

| Field Name | Shortcode | Description |
| ---- |
| **Site Title** | `{{site_title}}` | Displays the title of your campaign or site. |
| **Campaign End Date** | `{{end_date}}` | The date your campaign is set to finish. |
| **First Name** | `{{first_name}}` | The subscriber's first name. |
| **Last Name** | `{{last_name}}` | The subscriber's last name. |
| **Full Name** | `{{full_name}}` | The subscriber's full name. |
| **Subscriber Email** | `{{subscriber_email}}` | The email address of the subscriber. |
| **Referral ID** | `{{referral_id}}` | The unique ID assigned to the subscriber. |
| **Referral Link** | `{{referral_link}}` | The unique link the user shares to earn points. |
| **Spot In Line** | `{{spot_in_line}}` | The user's current rank or position in the campaign. |
| **Total Users in Line** | `{{total_users}}` | The total number of participants in the campaign. |
| **Points Per Referral** | `{{points_per_referral}}` | Points earned for referring a new user. |
| **Points Per Share** | `{{points_per_share}}` | Points earned for sharing the campaign. |
| **Points Per Visit** | `{{points_per_visit}}` | Points earned for visits via their link. |
| **User Entries** | `{{user_entries}}` | Total entries the user has accumulated. |
| **User Referrals** | `{{user_referrals}}` | The number of people the user has referred. |
| **User Shares** | `{{user_shares}}` | The number of times the user has shared. |
| **Referred Visits** | `{{user_views}}` | The number of clicks on the user's referral link. |
| **Total Campaign Entries** | `{{total_entries}}` | The total entries collected across the entire campaign. |
| **Unsubscribe Link** | `{{unsubscribe}}` | A mandatory link allowing users to opt-out of emails. |

---

## ✉️ Usage Examples

### 1. Personalizing a Welcome Email for a Waitlist
Copy the code below to create a personal welcome message focused on a user's progress.

**Editor Input (Copy this):**
```text
Hi {{first_name}},

Thanks for joining {{site_title}}! 

You currently have {{user_entries}} entries and have already referred {{user_referrals}} friends to the waitlist. 

Keep sharing your unique link to earn more rewards: 
{{referral_link}}
```

**What the User Sees:**
Hi **Sarah**,

Thanks for joining **PerkZilla**! 

You currently have **550** entries and have already referred **5** friends to the waitlist. 

Keep sharing your unique link to earn more rewards: 
`https://my.perkzilla.com/xyz?ref=123abc`

---

### 2. Status Update Footer (Before / After)
This table shows exactly how the shortcodes translate into a live status update for your users.

| Editor Input | User Live View |
| ---- |
| **Referrals:** `{{user_referrals}}` | **Referrals:** 5 |
| **Points:** `{{user_entries}}` | **Points:** 550 |
| **Rank:** #`{{spot_in_line}}` | **Rank:** #45 |
| [Unsubscribe](`{{unsubscribe}}`) | [Unsubscribe](https://unsubscribe-link.com) |

| Use the **Unsubscribe** shortcode in your footer to ensure compliance with spam regulations.