7.1.2 Beginner Tutorials — Publish Content with Planner

This tutorial walks through publishing content using the Planner. It introduces basic scheduling concepts and shows how to move content from draft to published state at a specific time.

Step 1: Prepare Content

Ensure the content entry is complete and validated. Only entries that pass validation can be scheduled.

Checklist:

Required fields filled

Media assets attached

Localization reviewed where applicable

Step 2: Open the Planner

From the content editor or list view, open the Planner for the selected entry. Access depends on publishing permissions.

Step 3: Choose Publish Action

Select the publish action. The Planner displays available actions based on the content type and workflow.

Available options:

Publish immediately

Schedule for later

Step 4: Set Schedule

If scheduling, define the execution time and timezone.

Scheduling rules:

Timezone-aware execution

Future times only

Deterministic execution

Example schedule:

POST /api/v1/plans { "action": "content.publish", "execute_at": "2025-02-01T09:00:00Z", "payload": {"content_id":"uuid"} }

Step 5: Review and Confirm

Review the planned action before confirming. Once confirmed, the plan is created and visible in the Planner overview.

Step 6: Monitor Execution

The Planner tracks execution state.

Possible states:

Pending

Executing

Completed

Failed

Failures are reported with actionable error messages.

Step 7: Verify Publication

After execution, verify that the content is published and visible through delivery channels such as the CMS Public API.

Best Practices

Use scheduling for predictable releases and avoid last-minute changes close to execution time. Review timezone settings carefully to prevent unintended publish times.