Skip to main content

​
What are Connectors?

Connectors are the bridge between Skayle and your content management system. They handle:
  • Authentication with your CMS
  • Taxonomy synchronization (categories, tags, authors)
  • Content formatting for each platform
  • Automated publishing on schedule
  • Article updates and deletions
Each organization can only have one active CMS connection at a time. This ensures content consistency and prevents publishing conflicts.

​
Available Connectors

WordPress

Connect to self-hosted WordPress or WordPress.com sites using the REST API and Application Passwords.

Sanity

Publish to Sanity’s structured content platform with Portable Text formatting.

Webflow

Push content to Webflow CMS collections with automatic HTML formatting.

Contentful

Integrate with Contentful’s content infrastructure using Rich Text format.

Headless Mode

Use Skayle as your CMS and consume content via our REST API.

​
Connector Architecture

All connectors implement a common interface that provides consistent behavior across platforms: 
interface Connector {
  // Test the connection to the CMS
  testConnection(): Promise<{ success: boolean; error?: string }>;

  // Sync taxonomies FROM the CMS TO Skayle
  syncTaxonomiesFromCms(): Promise<TaxonomySyncResult>;

  // Sync taxonomies FROM Skayle TO the CMS
  syncTaxonomiesToCms(): Promise<TaxonomySyncResult>;

  // Publish an article to the CMS
  publishArticle(article: ArticleData): Promise<PublishResult>;

  // Update an existing article in the CMS
  updateArticle(article: ArticleData, externalId: string): Promise<PublishResult>;

  // Delete an article from the CMS
  deleteArticle(externalId: string): Promise<{ success: boolean; error?: string }>;
}

​
How Publishing Works

1

Schedule Articles

Set a publish date for your articles in the batch editor or article view.
2

Automatic Detection

A background job runs every 5-15 minutes checking for articles ready to publish.
3

Content Formatting

Skayle converts your article content to the format required by your CMS (HTML, Portable Text, Rich Text, etc.).
4

Taxonomy Mapping

Categories, tags, and authors are mapped to their CMS equivalents using the taxonomy mapping table.
5

Publishing

The article is pushed to your CMS via its API, and Skayle stores the external ID and URL.

​
Taxonomy Mapping

Skayle maintains a bidirectional mapping between your Skayle taxonomies and CMS taxonomies:
SkayleDirectionCMS
Categories↔Categories/Collections
Tags↔Tags/Keywords
Authors↔Users/Authors
Taxonomy sync is non-destructive. Skayle will never delete taxonomies from your CMS or from Skayle during sync operations. It only creates new items or updates existing ones.

​
Sync Directions

  • CMS → Skayle: Import existing taxonomies from your CMS into Skayle
  • Skayle → CMS: Push Skayle taxonomies to your CMS (creates if not exists)
Taxonomies are matched by slug (case-insensitive). If a match is found, the existing item is updated. If no match is found, a new item is created.

​
Content Formatting

Each connector handles content formatting differently based on the target CMS:
ConnectorInput FormatOutput Format
WordPressBlockNote JSONHTML
SanityBlockNote JSONPortable Text
WebflowBlockNote JSONMinified HTML
ContentfulBlockNote JSONRich Text
HeadlessBlockNote JSONHTML (via API)
Skayle automatically handles the conversion from its internal BlockNote JSON format to whatever format your CMS requires. You don’t need to worry about formatting.

​
Choosing a Connector

FeatureWordPressSanityWebflowContentfulHeadless
Self-hosted✅❌❌❌✅
Media upload✅✅❌✅N/A
Custom fieldsLimited✅✅✅N/A
Taxonomy sync✅✅✅✅N/A
Scheduled publishing✅✅✅✅✅
API access✅✅✅✅✅

​
Next Steps

WordPress Setup

Connect to WordPress with Application Passwords

Taxonomy Sync

Learn about bidirectional taxonomy synchronization