Notion Setup
Notipo reads your blog posts from a Notion database. Each row is a post, and you control the publishing pipeline by changing a status property. This guide covers everything you need to set up your Notion database and connect it to Notipo.
Required Properties
Your Notion database needs these properties:
| Property | Type | Required | Description |
|---|---|---|---|
| Name | Title | Yes | The post title (default Notion title column) |
| Status | Select | Yes | Controls the pipeline (see trigger statuses below) |
| Category | Select | Yes | Auto-populated from your WordPress categories after connecting WordPress |
| Tags | Multi-select | No | Auto-populated from your WordPress tags |
| Slug | Text | No | Custom URL slug for the WordPress post (auto-generated from title if left blank) |
| Featured Image Title | Text | No | Text overlay on the generated featured image (defaults to post title if blank) |
| SEO Keyword | Text | No | Focus keyword for Rank Math SEO optimization |
| WordPress Link | URL | No | Auto-filled by Notipo after sync (edit link) or publish (live URL) |
Tip
Property names are case-sensitive. "Status" is not the same as "status". Use the exact casing shown above, or duplicate the template to avoid issues.
Trigger Statuses
The Status property drives the pipeline. These are the default values (configurable in Settings):
| Status Value | What Happens | Status After |
|---|---|---|
| Post to Wordpress | Syncs content from Notion and creates a WordPress draft | Ready to Review |
| Publish | Publishes the existing WordPress draft live | Published |
| Update Wordpress | Re-syncs content from Notion to WordPress (auto-publishes if already live) | Published or Ready to Review |
| Ready to Review | Set automatically after sync | — |
| Published | Set automatically after publishing | — |
Add all five values as options in your Status select property. The template has these pre-configured. You can rename the trigger statuses in Notipo's Settings page if you prefer different labels.
Connecting via OAuth
Notion is connected via OAuth — no manual token setup needed.
Tip
Credentials, database ID, and webhooks are all configured automatically during the OAuth flow. Status changes are detected instantly via Notion webhooks.
- 1Go to Settings and click Connect to Notion
- 2You'll be redirected to Notion's authorization page. Review the permissions and click Next
- 1Choose Use a template provided by the developer to get the Notipo database template duplicated into your workspace automatically — with all required properties pre-configured. Or select Select pages to share if you already have your own database set up.
- 1Click Allow access
Tip
If you choose the template option, the database is created in your Private pages. You can move it to any workspace location after setup — Notipo will continue to access it via the OAuth connection.
Trigger Detection
Notipo detects status changes in two ways:
| Method | How It Works |
|---|---|
| Webhooks | Notion sends events instantly when pages change |
| Polling | Notipo queries the Notion API for pages with trigger statuses every 5 minutes |
| Sync Now | Manual button on the dashboard for instant polling |
Troubleshooting
"Notion not configured" or posts not syncing
- Try disconnecting and reconnecting Notion in Settings
- Check that the Status property options match the trigger statuses exactly (e.g. "Post to Wordpress", not "Post to WordPress")
Status changes not detected
- Click Sync Now on the dashboard to trigger an immediate poll
- Check that your Notion database is shared with the Notipo integration
Category and tag options not showing in Notion
- Categories and tags are synced from WordPress to Notion when you connect WordPress or when you click Sync Categories on the Categories page
- Make sure both Notion and WordPress are connected before syncing