WordPress Publishing

Floyi’s WordPress Publishing integration lets you push finished content from the Content Creation workspace straight to your WordPress site. No copy-pasting, no reformatting. Your drafts arrive in WordPress with the correct post type, categories, tags, author, and SEO metadata already set.

• How to install the Floyi Connect plugin on WordPress
• How to connect your WordPress site to Floyi
• How to publish, schedule, and update articles
• How to configure SEO metadata for Yoast, Rank Math, AIOSEO, and SEOPress
• How to manage connected sites and troubleshoot issues

Before you can connect a WordPress site, you need to install the Floyi Connect plugin on that site.

[!NOTE] We are currently applying for the Floyi Connect plugin to be listed in the official WordPress Plugin Directory. Until it is approved, you can download the plugin directly from the link below.

1. Download the Floyi Connect plugin from floyi.com/wordpress-plugin.
2. In your WordPress admin, go to Plugins > Add New > Upload Plugin.
3. Upload the plugin ZIP file and click Install Now.
4. Click Activate after installation completes.
5. Navigate to Settings > Floyi in your WordPress admin to confirm the plugin is active.

After activation, the plugin will display a “Not Connected” status with instructions to connect to Floyi.

Connection uses a secure token-based handshake. You generate a token in Floyi, paste it in WordPress, and the two systems authenticate automatically.

In Floyi:

1. Go to Settings > Integrations.
2. Scroll to the WordPress section.
3. Click Connect Site.
4. A modal appears with a connection token and a 10-minute countdown timer.
5. Click the Copy button to copy the token to your clipboard.

In WordPress:

6. Go to Settings > Floyi in your WordPress admin.
7. Paste the token into the Connection Token field. The format is XXXX-XXXX-XXXX.
8. Click Connect.

The plugin sends your site details to Floyi and establishes a secure connection. Once complete, both Floyi and WordPress will show a green “Connected” status.

[!TIP] The connection token expires after 10 minutes. If it expires before you paste it, close the modal in Floyi and click Connect Site again to generate a new token.

When your WordPress site connects, Floyi receives:

• Site name and URL
• Available post types (Posts, Pages, and any custom post types)
• Categories and tags available on the site
• Authors who can be assigned to posts
• SEO plugin name and version (if installed)
• Editor type (Block Editor or Classic Editor)

Floyi never receives your WordPress login credentials. All communication uses signed API requests.

After connecting, your WordPress site appears in Settings > Integrations under the WordPress section.

Each connected site shows:

• Site name and URL (clickable to visit)
• Status badge — Connected (green), Disconnected (yellow), or Failed (red)
• SEO plugin — Detected plugin name and version, if any
• Health check button — Tests the connection and shows response latency
• Disconnect button — Removes the connection

Click the health check icon on any connected site to verify the connection is working. A successful check shows the response time (e.g., “Connection healthy (245ms)”). If the check fails, review the error message and verify that:

• The Floyi Connect plugin is still activated in WordPress
• Your WordPress site is accessible (not in maintenance mode)
• The site URL has not changed

Your Floyi plan determines how many WordPress sites you can connect. The connection count appears as a badge (e.g., “2/5”) next to the section header. If you reach your limit, disconnect an unused site or upgrade your plan.

1. Click the Disconnect button (trash icon) on the site card.
2. Confirm the disconnection in the dialog.

Disconnecting removes the active link between Floyi and WordPress. Previously published posts remain on WordPress. You can reconnect the same site later by generating a new token.

You can also disconnect from the WordPress side by going to Settings > Floyi and clicking Disconnect.

You can publish any article from the Content Creation workspace to a connected WordPress site.

1. Open an article in the Content Editor.
2. Click the Publish to WordPress button in the toolbar or header.
3. The publish modal opens with your publishing options.

If you have multiple connected sites, choose the target site from the Site dropdown. The dropdown shows each site’s name and URL.

Click Refresh from WordPress to pull the latest categories, tags, authors, and pages from your site. This is useful if you recently added new categories or authors in WordPress.

Select the content type for your article:

[!NOTE] Once an article is published to WordPress, the post type cannot be changed. Choose carefully before your first publish.

When publishing as a Page, you can select a parent page to place your content within WordPress’s page hierarchy. The dropdown shows your existing pages with indentation to indicate nesting.

For example, selecting “Products” as a parent for a page titled “Best SEO Tools” would create the URL path /products/best-seo-tools/.

Select (No parent - top level) to create a top-level page.

Choose how the article should appear on WordPress:

When you select Schedule, a date and time picker appears. Choose your desired publish date and the article will go live automatically at that time.

For Post type articles, you can assign categories and tags from your WordPress site.

• Categories appear as selectable buttons. Click to toggle selection.
• Tags appear as selectable buttons (up to 20 shown). Click to toggle.

If no categories or tags appear, click Refresh from WordPress to load them from your site.

Choose which WordPress author should be credited for the post. The dropdown lists all authors from your connected site.

If your WordPress site has a supported SEO plugin installed, Floyi can send SEO metadata along with your content.

Supported SEO plugins:

• Yoast SEO
• Rank Math
• All in One SEO (AIOSEO)
• SEOPress

Expand the SEO Metadata section to configure:

Floyi auto-fills these fields from your content brief when available. You can edit them before publishing.

Toggle Include SEO metadata when publishing to control whether SEO data is sent. If no SEO plugin is detected on your site, a warning appears — the metadata will still be sent but may not be used.

[!TIP] Character count indicators appear next to the SEO Title and Meta Description fields. Orange warnings show when you exceed the recommended limits.

After configuring your options, click the publish button. The label changes based on your selected status:

• Publish — for immediate publication
• Save as Draft — for draft status
• Schedule — for future publication

A loading state appears while the article is being sent to WordPress. Once complete, you see a success screen with a link to View on WordPress (for published posts) or Preview on WordPress (for drafts).

When you edit an article in Floyi after it has been published to WordPress, the publish modal shows a blue banner indicating the article is already live.

1. Open the previously published article in the Content Editor.
2. Click Publish to WordPress.
3. The modal shows a “Published on WordPress” banner with:
   • Current WordPress status (Live, Draft, Private, Pending, or Scheduled)
   • Last updated date
   • A link to view the live page
   • A “(Changes pending)” note if the Floyi version has changed since last publish
4. Modify any publishing settings if needed (categories, tags, SEO metadata).
5. Click Update to push the latest version.

The updated content replaces the existing WordPress post. The WordPress post ID, URL, and permalink remain the same.

If someone changes the post status directly in WordPress (e.g., unpublishes a post), click Sync from WordPress to pull the latest status back into Floyi.

Floyi automatically converts your editor content to the appropriate WordPress format.

If your site uses the Block Editor, Floyi converts your content into native Gutenberg blocks:

• Headings (H1–H6)
• Paragraphs
• Ordered and unordered lists
• Tables
• Code blocks
• Blockquotes
• Images

If your site uses the Classic Editor, content is delivered as clean HTML that renders correctly in the classic editing view.

The editor type is auto-detected during connection. You do not need to configure this manually.

After connecting, the Floyi Connect plugin settings page in WordPress (Settings > Floyi) shows:

• Connected (green badge) with your Site ID, connection date, and last sync time
• Disconnect button to remove the connection

A summary of what Floyi can see on your site:

• Post Types (e.g., “Post, Page, Project”)
• Categories count
• Tags count
• Authors count
• SEO Plugin (e.g., “Yoast SEO 19.5” or “None detected”)
• Editor type (Block Editor or Classic Editor)

The plugin uses webhooks to notify Floyi when post statuses change in WordPress. The queue shows:

• Pending — Webhooks waiting to be sent
• Retrying — Webhooks that failed and are being retried
• Failed — Webhooks that could not be delivered after multiple attempts

Failed webhooks do not affect your published content. They only mean that Floyi may not reflect the latest WordPress status until the next manual sync.

Technical details for troubleshooting: WordPress version, PHP version, plugin version, and site URL.

When you publish an article that is linked to a topic in your Topical Map, Floyi automatically updates your Topical Authority data:

• The topic node is marked as Published in the Topical Authority Planner
• Your coverage metrics update to reflect the newly published content
• The Topical Authority Scorecard reflects the change in your next refresh

This creates a closed loop: plan topics in your Topical Map, create briefs and drafts, publish to WordPress, and track authority growth — all within Floyi.

WordPress publishing is available to team members based on their role:

The number of connections depends on your Floyi plan. Your current usage and limit are shown in the WordPress section header (e.g., “2/5”). Free plans do not include WordPress publishing.

Yes. Open the publish modal and select a different site from the dropdown. Each site maintains its own publish record, so you can publish the same Floyi article to multiple WordPress sites with different settings.

Previously published posts remain on WordPress. After reconnecting, Floyi creates a new connection record. Existing publish records from the previous connection are preserved but linked to the old connection.

Click Refresh from WordPress in the publish modal to reload your site’s categories, tags, and authors. If they still do not appear, verify that categories and tags exist on your WordPress site and that the Floyi Connect plugin is active.

Floyi only creates or updates posts that were published through Floyi. It never modifies posts that were created directly in WordPress.

Floyi retries failed publish attempts up to 3 times with increasing delays. If all retries fail, you see an error message with details. Click Try Again to manually retry. Common causes include:

• WordPress site is temporarily unreachable
• The Floyi Connect plugin was deactivated
• WordPress server returned an error (disk full, database issue)

Yes. Select Schedule as the publish status, then pick your desired date and time. The post will go live automatically at the scheduled time, handled entirely by WordPress.

Floyi detects and sends metadata to: Yoast SEO, Rank Math, All in One SEO (AIOSEO), and SEOPress. If you use a different SEO plugin, the metadata is still sent but may not be picked up by your plugin.

The publish modal shows a “(Changes pending)” indicator when the article in Floyi has been modified since the last publish. Click Update to push the latest version.

Yes. All communication between Floyi and your WordPress site uses HMAC-SHA256 signed requests. Floyi never stores or transmits your WordPress login credentials. Connection tokens expire after 10 minutes and can only be used once.