Skip to content
// wordpress integration

Publish to WordPress directly from your pipeline.

Newsmill connects to any self-hosted WordPress site or WordPress.com installation via the REST API. Articles flow from your pipeline directly into WordPress as drafts or published posts — with categories, featured images, and custom fields intact.

Overview

The WordPress integration uses WordPress Application Passwords for authentication — a secure, token-based method that does not require sharing your main login credentials. Each Newsmill connection gets its own application password, which can be revoked independently without affecting other integrations or your admin access.

Once connected, Newsmill pushes articles to WordPress via the WP REST API. You control how content arrives: as drafts for editorial review, as scheduled posts for timed publication, or as immediately published articles for real-time pipelines. Category and tag mapping ensures content lands in the right section of your site without manual intervention.

For publishers running multiple WordPress sites — a common setup for niche media companies — Newsmill supports multi-site configurations. Each pipeline can target a different WordPress installation, allowing you to manage a portfolio of sites from a single Newsmill dashboard.

Setup guide

1. Generate an application password

In your WordPress admin panel, navigate to Users → Your Profile → Application Passwords. Enter a name for the connection (e.g., "Newsmill Pipeline") and click "Add New Application Password." Copy the generated password — it will only be shown once.

2. Configure the connection in Newsmill

In your Newsmill dashboard, go to Settings → Integrations → WordPress. Enter your WordPress site URL, your WordPress username, and the application password you generated. Click "Test Connection" to verify that Newsmill can reach your site's REST API.

3. Map categories and post settings

Choose default post settings: publish status (draft, pending, published), default category, and whether to include featured images. You can override these per pipeline if different content streams target different sections of your site.

4. Assign to a pipeline

In your pipeline settings, select WordPress as the publishing destination. Articles that pass through the pipeline will be automatically pushed to your WordPress site according to your configured settings.

Advanced configuration & troubleshooting

If you encounter authentication errors, verify that the Application Passwords feature is enabled on your WordPress installation. Some security plugins disable this feature by default. Check that your site URL includes the correct protocol (https://) and does not include a trailing slash.

For sites behind HTTP Basic Auth (common in staging environments), you may need to add the staging credentials separately. Newsmill supports passing Basic Auth headers alongside Application Password authentication for these scenarios.

Timeout errors typically indicate that your WordPress host has aggressive request limits. Consider increasing the PHP max_execution_time or contact your host about API rate limits. Newsmill retries failed requests up to three times with exponential backoff.

Permission errors (403 responses) usually mean the WordPress user associated with the application password lacks the "publish_posts" capability. Ensure the user has an Editor or Administrator role.

Ready to get started?

Connect your WordPress site and start publishing from your pipeline in minutes.