Why Webflow?
Webflow’s API-based integration gives you flexibility with your CMS structure. ChatFeatured automatically maps article fields (title, slug, body) to your Webflow collection, and you can configure optional field mappings for custom metadata.The Webflow integration uses their API to sync content directly into your collections. This means no plugin installation needed—just authenticate with your API token and start publishing.
Setup Instructions
Step 1: Get Your Webflow API Token
- Log in to your Webflow Dashboard
- Click your account name (top-left) → Settings
- Navigate to Apps & Integrations → API access
- Scroll to API access section
- Click Generate API token
- Enable these scopes:
sites:read,cms:read,cms:write - Copy the generated token (save it securely)
Step 2: Select Your Site and Collection
- In ChatFeatured, go to Integrations → Webflow
- Enter your Webflow API Token
- Click Test Connection to authorize
- Select your Webflow site from the dropdown
- Select the CMS collection where you want articles published (should have fields for title, slug, and body at minimum)
Step 3: Map Your Fields
ChatFeatured automatically maps these fields:- Title → Your collection’s title field
- Slug → Your collection’s slug field
- Body → Your collection’s body/content field
Step 4: Start Publishing
- Generate an article in ChatFeatured
- Click Publish
- Select Webflow as destination
- Configure publishing options:
- Status: Draft or Published
- Collection: Choose which collection
- Click Publish to Webflow
Publishing Options
Article Status
- Draft — Article saves as unpublished in Webflow, visible only in CMS editor
- Published — Article immediately appears on your live site
Field Mapping
ChatFeatured syncs these fields by default:| ChatFeatured Field | Webflow Field |
|---|---|
| Title | Title |
| Slug | Slug |
| Content | Body |
| Excerpt | Description (if available) |
| Featured Image | Featured Image (if available) |
Advanced Features
Collection-Specific Publishing
If you have multiple collections (Blog, News, Resources), you can publish to different collections. ChatFeatured remembers your last selection.Draft & Publish Workflow
Publish as draft, review in Webflow, then publish live when ready. This preserves Webflow’s editorial workflow.Bulk Publishing
If you generate multiple articles, you can publish them all to Webflow in batch. Each will sync to your collection.Best Practices
- Map all relevant fields during setup for better automation
- Publish as draft first to review before going live
- Keep your API token secret and rotate it periodically
- Test with one article before bulk publishing
Troubleshooting
'Invalid API Token' Error
'Invalid API Token' Error
Cause: Token is expired, invalid, or missing required scopesSolution:
- Generate a new API token in Webflow Settings
- Verify you enabled
cms:readandcms:writescopes - Copy the entire token (no spaces or truncation)
Collection Not Found
Collection Not Found
Cause: Collection doesn’t exist or API token lacks accessSolution:
- Verify the collection exists in your Webflow site
- Regenerate your API token with proper permissions
- Ensure the collection has at least Title, Slug, and Body fields
Article Publishes But Fields Are Empty
Article Publishes But Fields Are Empty
Cause: Field mapping is incorrectSolution:
- Check that your Webflow collection has matching field types
- Re-run field mapping in ChatFeatured settings
- Manually edit the article in Webflow to fill missing fields
'Slug Already Exists' Error
'Slug Already Exists' Error
Cause: An article with that slug already exists in your collectionSolution:
- Modify the slug in ChatFeatured before publishing
- Or: publish with a unique slug, then change it in Webflow
API Rate Limiting
API Rate Limiting
Cause: Too many requests to Webflow API in short timeSolution:
- Wait a few minutes before publishing again
- Publish articles in smaller batches
- Contact Webflow support if limit is too restrictive
Can't See My Collection
Can't See My Collection
Cause: Webflow may require admin permissionsSolution:
- Try with a different user role with higher permissions
- Verify the API token was generated with an admin account
Article Won't Publish
Article Won't Publish
Cause: Required fields are not mapped or field types don’t matchSolution:
- Check all required fields are mapped
- Verify field types match (text, long text, etc.)
- Re-test the connection in ChatFeatured
Images Not Syncing
Images Not Syncing
Cause: Image URLs are private or blockedSolution:
- Ensure image URLs are public and not blocked
- Webflow requires accessible image URLs for syncing
- Test the image URL in your browser to verify accessibility
Scheduling Not Working
Scheduling Not Working
Cause: Webflow API doesn’t support scheduled publishingSolution:
- Publish as draft and schedule in Webflow editor instead
- Or publish immediately and adjust dates in Webflow manually
See Also
- Agent Analytics with Webflow — Track AI bot activity on a Webflow-hosted site
- WordPress Integration — Native plugin setup
- Framer Integration — Similar CMS sync approach
- REST API — Direct API access without CMS