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

# Webflow Setup

> Connect Skayle to Webflow CMS, map article and taxonomy fields, configure API access, and publish structured content safely through your existing collections.

## 1. Overview

Webflow connector publishes Skayle posts to a selected Webflow CMS collection.

It requires:

* `siteId`
* `token`
* `collectionId`
* `fieldMapping`
* `taxonomyMapping`

## 2. Prerequisites

Before connecting:

* A Webflow site
* A CMS collection for blog posts
* Separate collections for category/tag/author taxonomies
* Reference fields in your post collection for taxonomy links

## 3. Creating API credentials

In Webflow:

1. Open `Site Settings -> Apps & Integrations -> API Access`.
2. Create a token for Skayle.
3. Copy token and Site ID.

In Skayle connector settings, enter:

* Site ID
* API token

## 4. Required permissions

Token should have read and write access for:

* Assets
* CMS
* Pages
* Sites

If permissions change, regenerate the token and update it in Skayle.

## 5. CMS-side setup

Create/confirm:

* Main post collection with fields for title, slug, excerpt, and rich text content
* Image/File field for featured image (if used)
* Optional publish date/status fields
* Category/tag/author collections
* Reference fields in post collection linking to those taxonomy collections

No webhook setup is required.

## 6. Connecting in Skayle

1. Open `Settings -> Connector`.
2. Select `Webflow`.
3. Enter Site ID and token, then test connection.
4. Select post collection.
5. Map Skayle fields to Webflow field slugs.
6. Map taxonomy collection IDs for category/tag/author.
7. Save connector.

## 7. Field mapping explanation

Required mappings:

* Title
* Slug
* Excerpt
* Content

Optional mappings:

* Featured image
* Publish date
* Status

Taxonomy mapping expects collection IDs for:

* Category collection
* Tag collection
* Author collection

Publish behavior:

* Published posts are created/updated as live items.
* Draft posts remain non-live.

## 8. Publishing test article

1. Create a draft post in Skayle.
2. Assign category/tag/author.
3. Publish from Skayle.
4. Confirm item appears in selected Webflow collection.
5. Verify item is live if published.
6. Verify taxonomy references resolve correctly.

## 9. Common errors & troubleshooting

| Issue                              | Likely cause                                 | Fix                                                 |
| ---------------------------------- | -------------------------------------------- | --------------------------------------------------- |
| Permission denied / missing scopes | Token scopes incomplete                      | Grant required scopes and regenerate token          |
| Slug already exists on republish   | Cached slug after unpublish/delete           | Republish your Webflow site, then retry             |
| Featured image not attached        | Mapped field is not Image/File               | Map to a valid Image/File field                     |
| Missing taxonomy links             | Reference fields or taxonomy mapping missing | Add reference fields and verify collection mappings |
| Collection not found               | Wrong `collectionId` or site mismatch        | Re-select collection from schema step               |

## 10. Best practices

* Use dedicated taxonomy collections with stable IDs.
* Keep slug conventions consistent to reduce collisions.
* After major unpublish/delete operations, republish site when needed.
* Validate one full publish/update/unpublish cycle before bulk publishing.