Contentful Integration
Connect WinSearch to your Contentful space and publish AI-optimized content to your content types.
Prerequisites
- Contentful space with appropriate content types
- Contentful account with API key access
- WinSearch account with CMS integration enabled
1Get Your API Keys
- Go to Settings → API keys in Contentful
- Click Add API key
- Copy your Space ID
- Copy your Content Management API token
Note: You need the Content Management API token, not the Content Delivery API token. This allows WinSearch to create and update entries.
2Connect in WinSearch
- Open WinSearch and go to Settings → Integrations
- Click Add Contentful Space
- Enter your Space ID
- Paste your Content Management API token
- Click Connect
3Map Content Types
Configure which Contentful content type to use for articles:
- Select your content type (e.g., "Blog Post")
- Map WinSearch fields to Contentful fields:
- Title → Your title field
- Content → Your body/content field
- Slug → Your slug field
- Meta Description → Your SEO field
- Save your mapping
Publishing Content
When publishing from WinSearch:
- New entries are created in your selected content type
- You can choose to publish immediately or save as draft
- Images are uploaded to Contentful's Asset library
Troubleshooting
Can't find my content type?
- Ensure the content type has required text fields
- Check that your API token has write access
- Verify you're selecting the correct environment