Skip to main content

​
Overview

Scheduled publishing allows you to set a future publish date for articles. Skayle’s sync job automatically publishes content when the scheduled time arrives.

​
How It Works

┌─────────────┐     Cron Job      ┌─────────────┐
│   Skayle    │ ────────────────► │    CMS      │
│  (queued)   │   Every 5-15 min  │ (published) │
└─────────────┘                   └─────────────┘
  1. Set a future publish date on your article
  2. Article enters the publishing queue
  3. Cron job runs every 5-15 minutes
  4. When publish time arrives, content syncs to CMS

​
Setting Up Scheduled Publishing

​
Step 1: Configure Publish Date

In the Skayle editor:
  1. Open your article
  2. Click Settings in the sidebar
  3. Set Publish Date to your desired time
  4. Save the article

​
Step 2: Queue for Publishing

  1. Click Schedule instead of Publish
  2. Article status changes to “Scheduled”
  3. Article appears in the publishing queue

​
Step 3: Monitor Queue

View scheduled articles in Content → Scheduled:
ArticleScheduled ForStatus
New Feature AnnouncementJan 20, 2024 9:00 AMQueued
Product UpdateJan 22, 2024 10:00 AMQueued

​
Cron Job Configuration

The sync job runs on a configurable interval:
SettingDefaultRangeDescription
Sync Interval5 min1-60 minHow often to check for scheduled content
Batch Size101-50Max articles per sync run
Retry Attempts31-10Retries on failure
Retry Delay60 sec30-300 secDelay between retries

​
Configuring the Interval

  1. Go to Settings → Publishing
  2. Set Sync Interval (recommended: 5-15 minutes)
  3. Save settings
Shorter intervals mean faster publishing but more API calls. Balance based on your CMS rate limits.

​
Publishing States

Articles move through these states: 
Draft → Scheduled → Publishing → Published
                  ↓
              Failed (retry)
StateDescription
DraftNot scheduled, won’t sync
ScheduledQueued for future publish
PublishingCurrently syncing to CMS
PublishedSuccessfully synced
FailedSync failed, will retry

​
Timezone Handling

All scheduled times are in your workspace timezone. Verify your timezone in Settings → General.
Skayle converts times to UTC for storage and back to your timezone for display:
  1. You schedule for “Jan 20, 9:00 AM EST”
  2. Stored as “Jan 20, 14:00 UTC”
  3. Displayed as “Jan 20, 9:00 AM EST”

​
Failure Handling

When publishing fails:
  1. Article marked as “Failed”
  2. Error logged with details
  3. Automatic retry after delay
  4. After max retries, requires manual intervention

​
Common Failures

  • Check CMS status page
  • Verify credentials haven’t expired
  • Will auto-retry
  • Reduce batch size
  • Increase sync interval
  • Will auto-retry with backoff
  • Check article content
  • Verify required fields
  • May need manual fix
  • Run taxonomy sync first
  • Check category/tag mappings
  • May need manual fix

​
Notifications

Configure notifications for publishing events:
EventNotification Options
PublishedEmail, Slack, Webhook
FailedEmail, Slack, Webhook
RetryingSlack, Webhook

​
Setting Up Notifications

  1. Go to Settings → Notifications
  2. Enable desired channels
  3. Configure webhook URLs or Slack integration
  4. Select events to notify

​
Best Practices

  1. Schedule with buffer: Schedule 15+ minutes in the future for reliability
  2. Check queue regularly: Monitor the scheduled queue for stuck items
  3. Test with drafts: Test your workflow with non-critical content first
  4. Set up notifications: Get alerted on failures immediately
  5. Sync taxonomies first: Ensure categories/tags exist before scheduling

​
Bulk Scheduling

Schedule multiple articles at once:
  1. Select articles in Content view
  2. Click Bulk Actions → Schedule
  3. Set publish date/time
  4. Optionally stagger (e.g., 1 hour apart)
  5. Confirm scheduling

​
Next Steps

Taxonomy Sync

Ensure taxonomies are synced before publishing

Content Formatting

Understand how content is converted