intermediate5 min read
Webflow CMS Connector
How the Webflow CMS destination works — creating collections, publishing items, and handling Webflow-specific limits.
Overview
Webflow is the primary destination for Trellis. Your content structures are synced to Webflow CMS collections, where they power your live website.
How it works
- Connect — authenticate with Webflow via OAuth. Trellis requests access to your site.
- Create or select a collection — Trellis can create a new CMS collection based on your architecture, or map to an existing collection.
- Publish — items are pushed to Webflow CMS via the API. They appear in your Webflow designer and on your live site.
Collection creation
When Trellis creates a new Webflow CMS collection, it:
- Sets the collection name and slug.
- Creates each field with the correct type, name, and validation.
- Configures the primary field (usually "Name" or "Title").
- Sets required/optional status for each field.
Field types in Webflow CMS
Webflow CMS supports these field types:
- Plain text — short strings, titles, names.
- Rich text — formatted content with headings, lists, links, images.
- Image — single image upload.
- Multi-image — gallery of images.
- Number — integers and decimals.
- Date/time — calendar dates with optional time.
- Boolean (switch) — yes/no toggle.
- Color — hex color value.
- Option (select) — single choice from predefined options.
- Reference — link to another collection item.
- Multi-reference — links to multiple collection items.
- File — downloadable file attachment.
- Link (URL) — web address.
- Email — email address.
- Phone — phone number.
Webflow CMS limits
Webflow imposes limits that affect your content architecture:
| Limit | Value | Impact |
|---|---|---|
| Collections per site | 40 (CMS plan) / 40 (Business) | Plan your collections carefully |
| Fields per collection | 60 | Plenty for most use cases |
| Items per collection | 2,000 (CMS) / 10,000 (Business) | Monitor growth |
| Multi-reference fields | 5 per collection | Use sparingly |
| Items per multi-reference | 25 per field | Limit relationship cardinality |
| API rate limit | 120 requests/min | Trellis handles throttling |
Publishing workflow
Trellis supports two publishing modes:
Draft mode
Items are created as drafts in Webflow CMS. Your team reviews and manually publishes each item. Best for content that needs editorial review.
Auto-publish mode
Items are created and immediately published. Best for synced data that is already reviewed in the source system (e.g., Airtable).
Tips
- Check your Webflow plan limits — collection and item limits vary by plan. Know your limits before building.
- Multi-reference is limited — only 5 multi-reference fields per collection and 25 items per field. Plan relationships accordingly.
- Field names affect CSS classes — Webflow generates CSS classes from field names. Use clean, descriptive names.
- Bulk operations reduce API calls — Trellis batches updates into groups of up to 100 items to stay within rate limits.
- Test in staging — Webflow supports staging environments. Test your sync configuration before pushing to production.
connectorwebflowcmspublishing