WordPress Integration

WordPress Integration

Surva.ai integrates with WordPress using the WordPress REST API and Application Passwords. This allows you to publish articles created in the Content Wizard directly to your WordPress site - either manually per article or automatically on a schedule through the auto-publish pipeline.

Prerequisites

• WordPress 5.6 or later (required for Application Passwords support)
• Administrator or Editor access to your WordPress site
• Active Surva.ai account with Content Wizard access
• HTTPS enabled on your WordPress site (required for secure API communication)

Setting Up the Integration

Step 1: Create an Application Password in WordPress

1. Log in to your WordPress admin dashboard
2. Go to Users > Profile
3. Scroll down to the Application Passwords section
4. Enter "Surva.ai" as the Application Name
5. Click Add New Application Password
6. Copy the generated password immediately - it will only be shown once

Application Passwords are separate from your regular WordPress password. They provide API-specific access without exposing your main login credentials.

Step 2: Connect in Surva.ai

1. Navigate to Settings > Integrations
2. Click Connect WordPress
3. Enter your WordPress site URL (e.g., https://yourblog.com)
4. Enter your WordPress username
5. Enter the Application Password you generated
6. Click Test Connection
7. If the test succeeds, click Save

The test connection verifies that Surva.ai can authenticate with your WordPress site and has the correct permissions to create posts.

Publishing Articles Manually

Once connected, you can publish any Content Wizard article to WordPress:

1. Create or open an article in the Content Wizard
2. Click Publish to CMS
3. Select WordPress as the destination
4. Choose the post status: Draft (review before publishing) or Published (goes live immediately)
5. Optionally select a WordPress category if you have categories configured
6. Click Publish

Surva.ai sends the article to WordPress via the REST API. You can verify it appeared in your WordPress admin under Posts.

Auto-Publishing Pipeline

For teams producing content regularly, the auto-publish pipeline automates the entire workflow:

Setting up auto-publish:

1. Go to Settings > Content Planner
2. Enable Auto-Publish
3. Select WordPress as the default CMS destination
4. Choose the default post status (Draft or Published)
5. Optionally set default categories and author mapping

How the auto-publish queue works:

• The generation queue processes pending articles every 15 minutes, sending them to the AI model for content creation
• The publish queue runs every 15 minutes (offset from the generation queue), sending completed articles to WordPress
• The daily scheduling job runs at 1 AM ET, queuing up any articles scheduled for that day
• Monthly article credit limits reset at midnight on the 1st of each month

You can override auto-publish settings per article. For example, set most articles to publish as Draft but mark specific high-confidence articles to go live immediately.

What Gets Synced to WordPress

When Surva.ai publishes to WordPress, the following data is sent:

• Article title - The headline from Content Wizard
• Article body - Full HTML content including headings, lists, tables, and inline links
• Featured image - The header image (DALL-E generated or Pexels stock, uploaded to your WordPress media library)
• Post status - Draft or Published based on your settings
• Categories - Mapped from Surva.ai content categories to your WordPress categories
• Author - Mapped to a WordPress user based on your author mapping configuration
• SEO metadata - If Yoast SEO or RankMath is installed, Surva.ai populates the meta title, meta description, and focus keyword fields
• Excerpt - A summary pulled from the article brief

SEO Plugin Compatibility

Surva.ai detects and integrates with popular WordPress SEO plugins:

• Yoast SEO - Meta title, meta description, and focus keyphrase are set via Yoast custom fields
• RankMath - Meta title, meta description, and focus keyword are set via RankMath custom fields
• No SEO plugin - Standard WordPress excerpt and title are used

If you have an SEO plugin installed, Surva.ai automatically detects it during the connection test and configures the appropriate field mappings.

Managing Published Content

After publishing to WordPress, you maintain full control:

• Edit the article directly in WordPress as you would any post
• Changes made in WordPress do not sync back to Surva.ai
• If you republish from Surva.ai, you can choose to create a new post or update the existing one
• Deleted WordPress posts are not affected by Surva.ai

Article Credits

Each article generated through the Content Wizard uses credits from your monthly allowance:

• Starter - 15 articles per month
• Growth - 30 articles per month
• Business - 60 articles per month

Credits reset on the 1st of each month. Publishing to WordPress does not use additional credits beyond the initial article generation.

Troubleshooting

Connection failed:

• Verify your site URL includes https:// and does not have a trailing slash
• Confirm the WordPress username is correct (not your email, unless your username is your email)
• Re-enter the Application Password exactly as generated, with spaces included

403 Forbidden:

• Your WordPress user account must have Editor or Administrator role
• Some security plugins (Wordfence, iThemes) may block REST API access - add an exception for Surva.ai

Application Passwords not available:

• Ensure you are running WordPress 5.6 or later
• Some hosting providers disable Application Passwords by default - contact your host to enable them
• Check that a security plugin is not disabling the Application Passwords feature

Featured image not appearing:

• Verify your WordPress theme supports post thumbnails (featured images)
• Check that the WordPress user has upload permissions (Editor or Administrator role)
• Large images may timeout on slower hosting - the article will still publish without the image

Frequently Asked Questions

Can I publish to multiple WordPress sites?

Each Surva.ai brand can connect to one WordPress site. If you manage multiple brands (Growth/Business plans), each brand can have its own WordPress connection.

Does Surva.ai modify my existing WordPress content?

No. Surva.ai only creates new posts or updates posts that it originally published. It never modifies content you created directly in WordPress.

Can I use this with WordPress.com?

Yes, as long as you are on a WordPress.com plan that supports the REST API and Application Passwords (Business plan or higher). Self-hosted WordPress.org sites work with all plans.