# WordPress

> Auto-generate featured images, Open Graph images, and insert renders into posts from Orshot templates

- **URL**: https://orshot.com/docs/integrations/wordpress

---

The Orshot WordPress plugin connects your WordPress site to Orshot so you can automatically generate featured images, Open Graph images, and embed renders directly in your posts — all from your Orshot templates.

**WordPress Plugin**: [https://wordpress.org/plugins/orshot](https://wordpress.org/plugins/orshot)

## Installation

1. In your WordPress admin, go to **Plugins > Add New**
2. Search for **Orshot**
3. Click **Install Now**, then **Activate**

Or upload manually:

1. Download the plugin zip from the WordPress plugin directory
2. Go to **Plugins > Add New > Upload Plugin**
3. Upload the zip and activate

## Connecting to Orshot

![](https://orshot.com/docs/integrations/wordpress-connect.png)

1. Go to **Settings > Orshot** in your WordPress admin
2. Click **Connect to Orshot**
3. You'll be redirected to Orshot to authorize the connection (OAuth — no API keys needed)
4. After authorizing, you'll be redirected back to WordPress with the connection active

## Auto Featured Images

Automatically generate a featured image from an Orshot template every time you publish a post.

1. Go to **Settings > Orshot**
2. Under **Auto Featured Image**, check **Auto-generate featured image on publish**
3. Click **Browse Templates** and select the template you want to use
4. If the template has multiple pages, choose which page to render
5. **Map template fields** to WordPress post data — for example, map the template's `title` field to **Post Title**, `excerpt` to **Post Excerpt**, etc.
6. Under **Post Types**, select which post types should get auto-generated images
7. Click **Save Changes**

Now when you publish or update a post, the plugin sends the post data to Orshot, renders the template, and sets the result as the featured image.

You can also manually generate or regenerate the featured image from the **Orshot Featured Image** panel in the block editor sidebar.

## Open Graph / Social Images

Pre-generate an OG image for social sharing when a post is published, so platforms like Twitter/X, Facebook, and LinkedIn show a rich preview.

1. Go to **Settings > Orshot**
2. Under **Open Graph / Social Image**, check **Auto-generate OG image on publish**
3. Click **Browse Templates** and select a template (typically 1200×630)
4. Map template fields to post data, same as featured images
5. Click **Save Changes**

The plugin injects `og:image` and `twitter:image` meta tags in the page `<head>` for each post that has a generated OG image.

## Gutenberg Block

Insert an **Orshot Image** block into any post or page to generate and embed an image inline.

1. In the block editor, add a new block and search for **Orshot Image**
2. Select a template from the dropdown
3. Click **Generate Image**
4. The rendered image is saved to your media library and embedded in the post

You can regenerate or change the template from the block's sidebar settings.

## Upload Receiver (Storage Push)

Orshot can push rendered files directly into your WordPress media library as a storage connection — useful for automation workflows.

1. Go to **Settings > Orshot** and copy the **Upload Token**
2. In your Orshot dashboard, go to **Workspace > Settings > Storage**
3. Add a WordPress connection and paste the upload token and your site URL

Rendered files from API requests or automations will be uploaded directly to your WordPress media library.

## Field Mapping Reference

When configuring auto featured images or OG images, you can map each template field to one of these WordPress post fields:

| Post Field             | Description                                 |
| ---------------------- | ------------------------------------------- |
| Post Title             | The post's title                            |
| Post Excerpt           | The excerpt (falls back to trimmed content) |
| Post Content (trimmed) | First 55 words of the post content          |
| Category               | The post's primary category name            |
| Author Name            | The post author's display name              |
| Publish Date           | The formatted publish date                  |
| Site Name              | Your WordPress site name                    |
| Permalink              | The post's full URL                         |
| Featured Image URL     | URL of the existing featured image          |

## Need Help?

- Contact support at hi@orshot.com or use the chat button in your Orshot dashboard for assistance