Skip to content
Letterhead Letterhead Letterhead Help Center
Admin Tools

Connecting WordPress

Edit in CMS

The Letterhead WordPress plugin connects your WordPress site directly to your Letterhead channels. Once connected, the plugin automatically syncs new and updated WordPress posts and tags into the Letterhead Content Library, making it easy to organize, manage, and publish website content in your newsletters.

Setting up the plugin is an admin task: you’ll need to be a company administrator in Letterhead.

The plugin helps you:

  • Automatically sync and curate WordPress content — posts, authors, and key metadata map directly into the Content Library, keeping newsletters up to date with minimal manual effort.
  • Maintain consistent tagging across platforms — WordPress tags sync into Letterhead, with updates reflected automatically.
  • Carry over custom fields — any custom field you’ve set up for your company fills automatically from the matching field on your post when you curate content, and from the plugin settings you can map any WordPress field to any Letterhead custom field. Custom fields belong to your company rather than to one newsletter, so the same set is available whichever newsletter you’re curating into. See Part 5 below.
  1. Log in to your WordPress dashboard.
  2. Go to Plugins → Add New and search for Letterhead.
  3. Find the plugin by tryletterhead, click Install Now, then Activate.
  1. In a new tab, log in to your Letterhead dashboard.
  2. Go to Settings → API Keys.
  3. Click + Generate new key, give it a name (e.g. “WordPress Connection”), and click Save. See Generate & manage API keys.
  1. Back in WordPress, go to Settings → Letterhead.
  2. Paste the key into the API Key field.
  3. Enter a Prefix for your site — this identifies the content’s source in Letterhead.
  4. Click Save. You should see a “Settings saved” confirmation.
  1. On the Letterhead settings page in WordPress, open the Channels tab.
  2. Under Mapped Channel, choose the Letterhead channel your WordPress posts should feed into.
  3. Click Save Mapping.

Part 5: Map WordPress fields to custom fields (optional)

Section titled “Part 5: Map WordPress fields to custom fields (optional)”

When you curate a post from your site, Letterhead fills your custom fields from it. Any custom field you’ve set up for your company fills from the field with the same name on the post, and you can map other WordPress data to any Letterhead custom field. You can map:

  • Custom fields
  • Advanced Custom Fields (ACF)
  • Meta Box fields
  • Pods fields
  • Categories and tags
  • Built-in WordPress metadata, such as the title and publish date

To set it up, open the field mapping section of the plugin settings, choose which WordPress field fills each Letterhead custom field, and save. On a multisite network, set up the mapping separately for each site.

From then on, the information you keep in WordPress flows into Letterhead whenever you curate a post, with no retyping, and mapped values can show in the sent email.

  1. Publish a new post in WordPress.
  2. In Letterhead, open Resources → Content Library.
  3. Your post appears in the list with its source marked as “Application”.
  4. WordPress categories map automatically to Letterhead tags, and matching custom fields fill in automatically.
  • My API key isn’t working. Go back to Settings → API Keys in Letterhead, generate a brand-new key, and paste the new secret into your WordPress settings.
  • My posts aren’t showing up in Letterhead. Make sure you clicked Save Mapping in the plugin’s Channels tab — without a mapped channel, Letterhead doesn’t know where to route your content.

See Working in Integrations, or contact support.

Still can’t find what you need? Contact support.