# How to Use the Letterhead WordPress Plugin

## This article explains how to install, connect, and use the Letterhead WordPress plugin so you can easily embed subscribe forms or newsletter content directly on your WordPress site.

### **Overview**

The Letterhead WordPress Plugin allows Letterhead organization and company admins to connect their WordPress site directly to their Letterhead channels. Once connected, the plugin automatically syncs new and updated WordPress posts & tags into the Letterhead Curations Library, making it easy to organize, manage, and publish website content in your newsletters.

To set up the plugin, you must be either a **Company Admin** or an **Organization Admin.**

Letterhead WordPress plugin helps you:

- **Automatically sync and curate WordPress content** by mapping posts, authors, and key metadata directly into the Letterhead Curations Library, keeping newsletters up to date with minimal manual effort.
- **Maintain consistent tagging across platforms** by syncing and managing WordPress tags in Letterhead, with updates reflected automatically.

### **Step-by-Step Instructions**

#### Part 1: Install the Plugin

1. Log in to your WordPress Dashboard.
2. Navigate to **Plugins** in the left-hand sidebar and click **Add New**.
3. In the search bar, type **Letterhead**.
4. Locate the plugin created by _tryletterhead_ and click **Install Now**.
5. Once installed, click **Activate**.

#### Part 2: Generate Your API Key

To connect WordPress to Letterhead, you need a secure key from your Letterhead account.

1. Open a new tab and log in to your **Letterhead Dashboard**.
2. Go to **Settings** and select **API Keys** from the menu.
3. Click the **\+ Generate new key** button.
4. Enter a name for the key (e.g., "WordPress Connection") and click **Save**.

#### Part 3: Configure Plugin Settings

1. Return to your WordPress Dashboard.
2. Navigate to **Settings** > **Letterhead**.
3. Paste the key you copied into the **API Key** field.
4. Enter a **Prefix** for your site (this helps identify the source of the content in Letterhead).
5. Click **Save**. You should see a "Settings saved" confirmation message.

#### Part 4: Map Your Channels

1. On the Letterhead settings page in WordPress, click the **Channels** tab.
2. You will see your Site Name listed. Click the dropdown menu under **Mapped Channel**.
3. Select the specific Letterhead channel you want your WordPress posts to feed into.
4. Click **Save Mapping**.

#### Part 5: Create and Use Content

1. Create and **Publish** a new post in WordPress.
2. Go back to your **Letterhead Dashboard**.
3. Navigate to **Newsletters** > **Curations**.
4. Your new WordPress post should appear in the list with the source marked as "Application."
5. Your WordPress categories are automatically mapped to Letterhead tags, meaning each WordPress category will appear as a curation tag within Letterhead.

* * *

### Troubleshooting & FAQs

- **My API key isn't working.** If you receive an error regarding the API key, return to the **Letterhead Settings > API Keys** section, generate a brand new key, and paste the new secret into your WordPress settings.
- **My posts aren't showing up in Letterhead.** Ensure that you have clicked **Save Mapping** in the _Channels_ tab of the plugin settings. If a channel is not selected, Letterhead will not know where to route your content.