> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatfeatured.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webflow Integration

> Sync articles from ChatFeatured to your Webflow CMS

The ChatFeatured Webflow integration allows you to publish articles directly to your Webflow site by connecting via API token. Articles sync with your Webflow CMS collection structure automatically.

**Status:** Available | **Setup time:** 10-15 minutes | **Complexity:** Beginner

## 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.

<Info>
  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.
</Info>

***

## Setup Instructions

### Step 1: Get Your Webflow API Token

1. Log in to your **Webflow Dashboard**
2. Click your account name (top-left) → **Settings**
3. Navigate to **Apps & Integrations → API access**
4. Scroll to **API access** section
5. Click **Generate API token**
6. Enable these scopes: `sites:read`, `cms:read`, `cms:write`
7. Copy the generated token (save it securely)

<Warning>
  Keep your API token secret—it grants full CMS access to your Webflow site. Never share it or commit it to version control. You can regenerate it anytime from Webflow settings.
</Warning>

### Step 2: Select Your Site and Collection

1. In ChatFeatured, go to **Integrations → Webflow**
2. Enter your **Webflow API Token**
3. Click **Test Connection** to authorize
4. Select your **Webflow site** from the dropdown
5. Select the **CMS collection** where you want articles published (should have fields for title, slug, and body at minimum)

<Tip>
  ChatFeatured will auto-detect your collection structure and available fields. This makes field mapping easier.
</Tip>

### 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

**Optional:** If you have custom fields (excerpt, author, featured image, etc.), configure mappings now. You can also map these after publishing.

<Tip>
  Set up all your custom field mappings during initial setup to avoid manual editing later. This saves time when publishing multiple articles.
</Tip>

### Step 4: Start Publishing

1. Generate an article in ChatFeatured
2. Click **Publish**
3. Select **Webflow** as destination
4. Configure publishing options:
   * **Status:** Draft or Published
   * **Collection:** Choose which collection
5. Click **Publish to Webflow**

Your article will appear in your Webflow CMS collection immediately.

***

## 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) |

Custom fields can be mapped during setup or edited post-publish in Webflow.

***

## 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.

<Tip>
  Always publish as draft first to review the article in your Webflow editor. This lets you catch any formatting issues before going live.
</Tip>

### 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

<Warning>
  **Don't** share your API token\
  **Don't** delete articles from ChatFeatured once published to Webflow (they won't sync)\
  **Don't** manually edit slug in Webflow after ChatFeatured publish (can cause sync issues)
</Warning>

***

## Troubleshooting

<Accordion title="'Invalid API Token' Error">
  **Cause:** Token is expired, invalid, or missing required scopes

  **Solution:**

  * Generate a new API token in Webflow Settings
  * Verify you enabled `cms:read` and `cms:write` scopes
  * Copy the entire token (no spaces or truncation)
</Accordion>

<Accordion title="Collection Not Found">
  **Cause:** Collection doesn't exist or API token lacks access

  **Solution:**

  * 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
</Accordion>

<Accordion title="Article Publishes But Fields Are Empty">
  **Cause:** Field mapping is incorrect

  **Solution:**

  * 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
</Accordion>

<Accordion title="'Slug Already Exists' Error">
  **Cause:** An article with that slug already exists in your collection

  **Solution:**

  * Modify the slug in ChatFeatured before publishing
  * Or: publish with a unique slug, then change it in Webflow
</Accordion>

<Accordion title="API Rate Limiting">
  **Cause:** Too many requests to Webflow API in short time

  **Solution:**

  * Wait a few minutes before publishing again
  * Publish articles in smaller batches
  * Contact Webflow support if limit is too restrictive
</Accordion>

<Accordion title="Can't See My Collection">
  **Cause:** Webflow may require admin permissions

  **Solution:**

  * Try with a different user role with higher permissions
  * Verify the API token was generated with an admin account
</Accordion>

<Accordion title="Article Won't Publish">
  **Cause:** Required fields are not mapped or field types don't match

  **Solution:**

  * Check all required fields are mapped
  * Verify field types match (text, long text, etc.)
  * Re-test the connection in ChatFeatured
</Accordion>

<Accordion title="Images Not Syncing">
  **Cause:** Image URLs are private or blocked

  **Solution:**

  * 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
</Accordion>

<Accordion title="Scheduling Not Working">
  **Cause:** Webflow API doesn't support scheduled publishing

  **Solution:**

  * Publish as draft and schedule in Webflow editor instead
  * Or publish immediately and adjust dates in Webflow manually
</Accordion>

***

## See Also

* [Agent Analytics with Webflow](/integrations/webflow-agent-analytics) — Track AI bot activity on a Webflow-hosted site
* [WordPress Integration](/integrations/wordpress) — Native plugin setup
* [Framer Integration](/integrations/framer-integration) — Similar CMS sync approach
* [REST API](/integrations/rest-api) — Direct API access without CMS
