WordPress Block

Overview

The WordPress block connects your workflows to a WordPress site. Use it to create new posts, update existing posts by slug, or upload images to the media library. It is the workflow-level counterpart to the WordPress integration.

Configuration

Select Connection

Choose the WordPress connection to use. The dropdown lists the WordPress connections in your workspace. You must connect a WordPress site before using this block. See the WordPress integration for connection setup, prerequisites, and re-authentication.

Select Action

Choose the operation to perform. Options:

Action	Description
Create Post	Add a new post to your site
Update Post	Modify an existing post by slug
Upload Image	Upload an image to the media library

Create Post

Add a new post to your WordPress site. Title and Content are required.

Title (Required)

The post title. Example:

{{step_1.output.title}}

Content (Required)

The post body. HTML is supported. Slate strips wrapper tags such as <html> and <body> and wraps bare text in paragraphs. Example:

{{step_2.output}}

Status

The post status. Default: Draft Options: Draft, Publish, Pending Review, Private.

Optional fields

Click Add field to include any of these. All accept placeholders.

Field	Description
Excerpt	Short summary
Slug	URL slug for the post
Categories	Comma-separated WordPress category IDs (e.g. `1,3,5`)
Featured Image ID	Media library ID for the featured image
Author ID	WordPress user ID for the author
Meta / ACF (JSON)	Custom fields or ACF data as JSON. The ACF field group must have “Show In REST API” enabled.
Template	Template slug
Post Type	WordPress post type (loaded from your site; defaults to standard posts)

Upload an image first with the Upload Image action, then pass the returned media ID into Featured Image ID.

Update Post

Modify an existing post by matching its slug. Only the fields you add are changed; everything else stays unchanged.

Post Slug (Required)

The slug of the existing post to update. Example:

{{step_1.output.slug}}

Status

The post status. Defaults to Draft when no status is set. Options: Draft, Publish, Pending Review, Private.

Optional fields

Click Add field to update any of these. All accept placeholders.

Field	Description
Title	New post title
Content	New post body (HTML)
Excerpt	New excerpt
Categories	Comma-separated category IDs
Featured Image ID	Media library ID for the featured image
Author ID	WordPress user ID for the author
Meta / ACF (JSON)	Custom fields or ACF data as JSON
Template	Template slug
Post Type	WordPress post type

Upload Image

Upload an image to the WordPress media library. The action returns a media ID you can use as a featured image.

Image Source

Choose where the image comes from.

Source	Description
URL (default)	Fetch an image from an external URL
Upload	Upload a file directly in the config
Drive	Pick an image from Slate Drive

For URL, set Image URL (e.g. https://example.com/image.jpg). For Drive, select a file or pass a Drive File ID placeholder.

Filename

Optional base name for the file. The extension is detected automatically from the image data.

Alt Text

Optional alt text for the image.

Media Title

Optional title for the media item.

Output Data

The block returns the created or updated post, or the uploaded media item. Access values in later steps with references such as {{step_n.output.id}}.

Create Post / Update Post

Returns the post object with these fields:

id — the WordPress post ID
date — post creation date
modified — last modified date
slug — the post slug
status — the post status, such as draft or publish
type — the WordPress post type
link — the live URL of the post
site_url — the WordPress site URL

Update Post also returns previous_status, previous_link, and lookup_slug.

Upload Image

Returns the media item with these fields:

id — the WordPress media ID (use this as a Featured Image ID)
date — upload date
image_url — the hosted image URL

Sample Output

Create Post:

{
  "id": 482,
  "date": "2026-06-13T10:24:00",
  "modified": "2026-06-13T10:24:00",
  "slug": "best-crm-software-2026",
  "status": "draft",
  "type": "post",
  "link": "https://example.com/?p=482",
  "site_url": "https://example.com"
}

Upload Image:

{
  "id": 517,
  "date": "2026-06-13T10:22:00",
  "image_url": "https://example.com/wp-content/uploads/2026/06/featured-image.jpg"
}

Error Handling

Common errors and solutions:

Error	Cause	Solution
Credentials not found	Connection deleted or revoked	Reconnect your WordPress site in the WordPress integration
Invalid credentials	Application password revoked or expired	Reconnect with WordPress login or a new application password
Insufficient permissions	WordPress user lacks rights	Use a user with Editor or Administrator role
Post type ”…” is not registered or not REST-enabled	Invalid Post Type value	Use a post type listed in the dropdown
Meta field contains invalid JSON	Malformed JSON in Meta / ACF	Provide valid JSON; for ACF, enable “Show In REST API”
Post with slug ”…” not found	No matching post for Update Post	Verify the slug exists on the site
WordPress site URL not configured	Connection missing host	Recreate the connection with a valid Site URL
File exceeds the server’s upload size limit	Image too large for the site	Use a smaller image or raise the WordPress upload limit
URL did not return an image	Image URL points to non-image content	Use a direct link to an image file

Best Practices

Start with Status set to Draft and publish after review.
Upload images before creating posts so you can set the featured image.
Use unique slugs to avoid collisions when creating posts.
For Update Post, only add the fields you intend to change.
Validate Meta / ACF JSON before mapping it into the block.
Look up category IDs in WordPress under Posts > Categories.
For bulk runs, pace the workflow to avoid hitting site rate limits.

Common Use Cases

Use Case	Configuration Tips
AI blog publishing	LLM block writes the post, WordPress block creates a draft
Bulk generation from a sheet	Loop over rows, LLM writes each post, WordPress creates drafts
Image-rich posts	Generate image, Upload Image, Create Post with the media ID
SEO landing pages	Semrush keyword data, LLM copy, Create Post with target slug
Content refresh	Sheet of slugs, LLM rewrites, Update Post by slug

What’s Next

Set up the connection in the WordPress integration
Generate content with the LLM Block
Process many posts with the Loop Block
Pull data from a sheet with the Google Sheets Block
Transform data with Liquid Templating

Getting Started

Cowork

Insights

Work

Automate

Assets

Integrations

Overview

Configuration

Select Connection

Select Action

Create Post

Title (Required)

Content (Required)

Status

Optional fields

Update Post

Post Slug (Required)

Status

Optional fields

Upload Image

Image Source

Filename

Alt Text

Media Title

Output Data

Create Post / Update Post

Upload Image

Sample Output

Error Handling

Best Practices

Common Use Cases

What’s Next

​Overview

​Configuration

​Select Connection

​Select Action

​Create Post

​Title (Required)

​Content (Required)

​Status

​Optional fields

​Update Post

​Post Slug (Required)

​Status

​Optional fields

​Upload Image

​Image Source

​Filename

​Alt Text

​Media Title

​Output Data

​Create Post / Update Post

​Upload Image

​Sample Output

​Error Handling

​Best Practices

​Common Use Cases

​What’s Next

Overview

Configuration

Select Connection

Select Action

Create Post

Title (Required)

Content (Required)

Status

Optional fields

Update Post

Post Slug (Required)

Status

Optional fields

Upload Image

Image Source

Filename

Alt Text

Media Title

Output Data

Create Post / Update Post

Upload Image

Sample Output

Error Handling

Best Practices

Common Use Cases

What’s Next