Setting Up CMS Integrations
Surva.ai integrates with popular content management systems to streamline your publishing workflow. This guide covers general setup principles and supported platforms.
Supported CMS Platforms
Surva.ai currently integrates with:
- WordPress - Full integration via REST API
- Webflow - CMS collection publishing
- Custom CMS - Via webhook or API
Integration Benefits
Connecting your CMS provides:
- One-click publishing from Surva.ai
- Automatic image uploads and optimization
- SEO metadata synchronization
- Draft and scheduled publishing
- Content status tracking
General Setup Steps
Most CMS integrations follow this pattern:
- Generate API credentials in your CMS
- Connect in Surva.ai Settings
- Authenticate with your credentials
- Select site/blog if you have multiple
- Map fields between Surva.ai and your CMS
- Test with a draft post
- Save the connection
Field Mapping Explained
Field mapping tells Surva.ai where to put content:
- Title - The headline of your article
- Body/Content - The main article HTML
- Excerpt/Summary - Short description
- Slug/URL - The URL path
- Featured Image - Hero or thumbnail image
- Categories/Tags - Taxonomy terms
- Author - Content author attribution
- Meta Description - SEO meta tag
Content Formatting
Surva.ai preserves formatting during publishing:
- Headers (H1-H6) maintained
- Lists (ordered and unordered) preserved
- Bold, italic, links work correctly
- Images embedded with alt text
- Code blocks formatted properly
Publishing Options
When publishing, you typically can choose:
- Draft - Save without publishing
- Publish immediately - Go live now
- Schedule - Publish at a future date/time
Auto-Publishing
Enable automatic publishing for approved content:
- Go to Settings then Content Settings
- Enable auto-publish for your connected CMS
- Set default publish status
- Choose default categories or collections
Managing Multiple Sites
If you have multiple websites:
- Connect each site separately
- Use different brands in Surva.ai for each site
- Choose destination when publishing
- Track which content went where
Webhook Integration
For unsupported CMS platforms, use webhooks:
- Go to Settings then Integrations
- Click Custom Webhook
- Enter your webhook endpoint URL
- Configure payload format
- Test the connection
Surva.ai will POST content data to your endpoint when publishing.
Security Best Practices
- Use application passwords, not main account passwords
- Create dedicated API users with limited permissions
- Regenerate tokens periodically
- Revoke access when no longer needed
- Monitor API usage in your CMS
Troubleshooting Common Issues
Connection timeout:
- Check your CMS site is accessible
- Verify firewall is not blocking API requests
- Ensure API endpoints are enabled
Permission denied:
- Confirm API user has publishing rights
- Check token has required scopes
- Verify collection/post type permissions