Skip to main content

​
Overview

Taxonomy synchronization keeps your categories, tags, and authors in sync between Skayle and your connected CMS. This ensures consistent content organization across platforms.

​
How It Works

Skayle maintains a mapping table that links Skayle taxonomy IDs to their corresponding CMS IDs: 
┌─────────────┐     Mapping Table     ┌─────────────┐
│   Skayle    │ ◄──────────────────► │    CMS      │
│  Taxonomy   │   skayle_id ↔ cms_id │  Taxonomy   │
└─────────────┘                       └─────────────┘

​
Sync Directions

Fetches taxonomies from your CMS and creates them in Skayle:
  1. Query CMS for all categories/tags/authors
  2. Create matching entries in Skayle
  3. Store ID mappings for future reference
Use when: Setting up a new Skayle workspace with existing CMS content

​
Supported Taxonomies

TaxonomyDescriptionRelationship
CategoriesContent classificationMany-to-many
TagsContent keywordsMany-to-many
AuthorsContent creatorsMany-to-one

​
Running a Sync

​
Manual Sync

  1. Go to Settings → Connectors
  2. Click Sync Taxonomies
  3. Select sync direction
  4. Review changes before applying
  5. Click Apply

​
Automatic Sync

Enable automatic sync to run before each publish:
  1. Go to Settings → Connectors
  2. Enable Auto-sync taxonomies
  3. Taxonomies sync automatically when publishing

​
Mapping Table

The mapping table stores relationships between Skayle and CMS IDs:
Skayle IDCMS IDTypeNameLast Synced
cat_12345categoryTechnology2024-01-15
cat_45667categoryBusiness2024-01-15
tag_78912tagJavaScript2024-01-15
author_1013authorJohn Doe2024-01-15

​
Platform-Specific Details

Categories: WordPress taxonomy category Tags: WordPress taxonomy post_tag Authors: WordPress users with author role
GET /wp-json/wp/v2/categories
GET /wp-json/wp/v2/tags
GET /wp-json/wp/v2/users?roles=author

​
Conflict Resolution

When the same taxonomy exists in both systems with different data:
If names differ, Skayle uses the CMS name by default. Configure to prefer Skayle names in settings.
Slugs are matched first. If a slug exists in CMS, it’s linked rather than creating a duplicate.
Deleted CMS items are marked as “orphaned” in Skayle. You can re-link or delete them.

​
Troubleshooting

  • Check connector credentials are valid
  • Verify taxonomy endpoints are accessible
  • Ensure proper permissions for reading taxonomies
  • Check slug matching is enabled
  • Verify existing mappings in the table
  • Run a full sync to reconcile
  • Some CMS platforms require taxonomies to be published
  • Check taxonomy visibility settings in CMS
  • Verify API permissions include taxonomy access

​
Best Practices

  1. Sync before publishing: Always sync taxonomies before publishing articles
  2. Use consistent slugs: Keep slugs consistent across platforms
  3. Review mappings: Periodically review the mapping table for orphans
  4. Backup before bulk sync: Export your taxonomies before large sync operations

​
Next Steps

Content Formatting

Learn how content is converted for each platform

Scheduled Publishing

Set up automated publishing