Publishing

Notipo uses a status-driven pipeline. You control everything by changing the Status property in your Notion database.

Pipeline Overview

StatusWhat HappensNotion Changes To
Post to WordpressSyncs content, images, SEO → creates WP draftReady to Review
PublishRe-syncs from Notion → publishes livePublished
Update WordpressRe-syncs content from Notion to WPSee below
1

Post to WordPress

When you set a post's status to Post to Wordpress, Notipo:

  • Fetches the Notion page content
  • Converts it to WordPress Gutenberg blocks (see supported blocks)
  • Uploads all images to your WordPress media library
  • Generates a featured image (Pro plan)
  • Sets Rank Math SEO metadata (title, description, focus keyword)
  • Creates a WordPress draft
  • Updates the Notion status to Ready to Review
  • Fills in the WordPress Link property with the wp-admin edit URL
2

Publish

After reviewing the draft in WordPress, change the Notion status to Publish. Notipo:

  • Re-syncs the latest content from Notion (so you can skip "Post to WordPress" and go straight to publish)
  • Publishes the post live (sets WP status to "publish")
  • Refreshes SEO metadata with the WordPress-generated excerpt
  • Updates Notion status to Published
  • Updates the WordPress Link to the live public URL
Tip
You can use either a two-step workflow (Post to WordPress → review → Publish) or a one-step workflow (set Publish directly to sync and go live in one action).

Updating Posts

To update an already-synced post, change the Notion status to Update Wordpress. The behavior depends on the current WordPress post status:

WP post is live
Re-syncs and auto-publishes → Notion: Published
WP post is a draft
Re-syncs content only → Notion: Ready to Review
WP post was deleted
Creates a fresh draft → Notion: Ready to Review

Deleting Posts

You can delete a post from the Posts page in the dashboard. When you delete a post, Notipo:

  1. 1Permanently deletes the WordPress post
  2. 2Deletes the featured image and all inline images from the WordPress media library
  3. 3Resets the Notion page status back to Draft
  4. 4Removes the post and all related data from the Notipo database

All WordPress cleanup is best-effort — if the WP post or images were already deleted manually, those steps are skipped without causing an error.

Sync Triggers

Notipo detects status changes in your Notion database through three methods:

  • Notion webhooks — changes are detected within seconds. Configured automatically for OAuth users. Pro plan only.
  • Polling — a safety-net poll runs every 5 minutes to catch any missed webhook events. Works on both Free and Pro plans.
  • Sync Now — click the button in the dashboard to trigger an immediate poll. Pro plan only, with a 15-second cooldown between presses to stay within Notion's rate limits.

Custom Trigger Statuses

The default trigger status values (Post to Wordpress, Publish, Update Wordpress) can be customized per account via the API. This lets you rename them to match your team's workflow — for example, changing "Post to Wordpress" to "Send to WP" or localizing the labels to another language.

Monitoring

The Notipo dashboard shows real-time progress of sync and publish jobs as they happen. Each step is displayed live — fetching from Notion, processing images, creating the WordPress draft, generating the featured image, and setting SEO metadata. No need to refresh the page.

The Jobs page shows a full history of all background operations. You can filter by status — All, Running, Completed, or Failed— to quickly find what you're looking for. Each job shows the post title, job type, timestamps, error messages, and a collapsible list of every step that was executed.

The Posts page lists all synced posts with their current status, a link to the WordPress draft or published post, and a delete button to remove posts with full WordPress cleanup.

Failure Handling

Important
If a sync or publish job fails, the Notion status is automatically reset so you can fix the issue and try again. For example, if a job fails while the status is "Syncing", it reverts back to "Post to Wordpress" so you can retry. Jobs that get stuck in a running state for more than 5 minutes are automatically marked as failed.

Webhook Notifications

Get notified instantly when jobs fail by connecting a Slack or Discord webhook. Pro plan only.

  1. 1Go to Settings in your dashboard
  2. 2Under Webhook Notifications, paste your Slack or Discord webhook URL
  3. 3Click Save, then click Test to send a test message and verify it works

When a sync or publish job fails, Notipo sends a notification with the post title and error details to your webhook. Messages use @channel to trigger push notifications so your team is alerted immediately.