Skip to main content

​
Overview

The WordPress integration allows Sight AI to publish articles directly to your WordPress site using our custom WordPress plugin. This provides secure API key authentication and seamless article syncing.

​
Setup Instructions

​
Step 1: Install the WordPress Plugin

Install the Sight AI Publisher plugin on your WordPress site:
  1. Download the plugin from the Setup tab in Sight AI
  2. Go to WordPress Admin > Plugins > Add New > Upload Plugin
  3. Choose the downloaded ZIP file and click “Install Now”
  4. Activate the plugin after installation

​
Step 2: Generate an API Key

In your WordPress admin:
  1. Navigate to Sight AI > API Keys
  2. Click “Generate New API Key”
  3. Copy the API key (you won’t see it again!)
  4. Paste it in the Sight AI integration form

​
Step 3: Choose How New Articles Are Published

The Setup tab now surfaces a clear publish-vs-draft choice so you decide upfront how new articles should land in WordPress:
  • Publish immediately (default for new connections) — new articles go live on your blog right away. Best for hands-off publishing.
  • Save as draft — articles wait in WordPress as drafts. You publish each one manually.
We default to Publish immediately because the most common confusion was: “I generated articles, Sight AI says they synced, but nothing appears on my blog.” That happens when articles silently land as drafts. Publishing immediately makes the behaviour match user expectation. You can always switch to Draft on the Settings tab if you prefer manual review.
If you need Pending Review or Private, configure them on the Settings tab — those modes are still supported but live behind a less-prominent control because they’re rarely used.

​
Step 4: Configure the Rest of the Settings

On the Settings tab you can also set:
  • Default Category — automatically assign to a WordPress category
  • Default Author — set which WordPress author is credited (learn how authors work)
  • Sync Featured Images — auto-upload featured and in-body images to WordPress Media Library
  • Sync SEO Metadata — automatically sync SEO titles and meta descriptions (compatible with Yoast SEO, RankMath, and other SEO plugins)

​
Step 5: Start Publishing

Once connected, you can publish articles directly from Sight AI:
  1. Go to any article in your dashboard
  2. Click “Sync to WordPress”
  3. Choose publishing options
  4. Your article will be instantly published!

​
What Gets Synced

  • Title — Article title
  • Content — Full HTML content with formatting
  • Featured Image — Uploaded to WordPress Media Library
  • In-Body Images — Uploaded and embedded in content
  • Meta Description — As excerpt (Yoast/RankMath compatible)
  • Slug — SEO-friendly URL
  • Category — Assigned category
  • Author — Assigned author

​
Autopilot Publishing

When Autopilot is enabled (Starter plan and above), articles are automatically published to WordPress based on your configuration settings.

​
Troubleshooting

​
Connection Failed

  • Check plugin activation: Ensure the Sight AI plugin is activated
  • Verify API key: Make sure you copied the full API key
  • Check site URL: Ensure the URL matches your WordPress site exactly
  • Try regenerating: Generate a new API key if needed

​
”Access Forbidden” Error

If you see an “Access forbidden” or “This site is private” error, your WordPress site visibility settings may be blocking API access.
  • Site must be Public: Go to Settings > Reading (or Settings > General on WordPress.com) and ensure your site is set to “Public”
  • Private sites block API: Sites set to “Private” or “Coming Soon” will reject all API requests, including from Sight AI
  • WordPress.com users: Check your site visibility in Settings > General > Privacy and select “Public”
  • Staging sites: WordPress.com staging sites must also be set to Public for the integration to work

​
Articles Not Appearing

  • Check status: Articles may be saved as drafts
  • Clear cache: WordPress caching plugins may delay visibility
  • Check WordPress: Look in Posts > All Posts for the article

​
Images Not Uploading

  • Check permissions: Your WordPress user needs upload capability
  • Check file size: Large images may exceed PHP limits
  • Check uploads folder: Ensure WordPress can write to uploads

​
Active CMS

Sight AI supports only one active CMS integration per site at a time. When you connect WordPress and set it as your active CMS, articles are synced to WordPress instead of any previously active CMS. You can switch to a different CMS at any time from the Integrations hub — your WordPress configuration and previously published articles are preserved.

​
Disconnecting

To disconnect WordPress:
  1. Go to Integrations
  2. Click WordPress
  3. Click “Disconnect”
  4. Confirm the disconnection
Previously published articles remain on your WordPress site.

​
Next Steps