Promotions
The Promotions page is your promotion history. Every promotion ever created in this workspace appears here — whether it was published manually, via schedule, or via the API. Navigate to it from Promotions in the top navigation.
Screenshot pending
/help/promotions/open_promotions_menu.png
Workspace sidebar with the Promotions menu item highlighted
See docs/help-screenshot-manifest.md for capture instructions.
Screenshot pending
/help/promotions/promotions_list_overview.png
Promotions list page showing a table of past promotions with reference ID, status badges, source snippet, target count, and scheduled/posted date columns
See docs/help-screenshot-manifest.md for capture instructions.
Review a promotion — step by step
Open the Promotions page
Filter to what you care about
Click a row to open the detail page
Retry, clone, or cancel
Status lifecycle
| Status | Meaning |
|---|---|
| ⚪ Draft | Saved but not yet published or scheduled. |
| 🟡 Scheduled | Queued to publish at a future time. |
| 🔵 Publishing | Actively posting to channels right now. |
| 🟢 Completed | All targets have been attempted. Some may have failed — check the detail view. |
| 🔴 Failed | All targets failed or the promotion could not be executed. |
| ⚫ Cancelled | Cancelled before all targets completed. Targets that had already posted remain posted. |
| 🟠 Blocked by rule | A hard-block targeting rule prevented posting to this channel. |
Filtering and searching
The Promotions list supports several filters at the top of the page:
- Status — filter to one or more statuses (e.g., show only Failed promotions).
- Connector — show only promotions that targeted a specific platform.
- Date range — narrow to a date window.
- Search — full-text search across the source content and promotion reference IDs (e.g., PROM-00042).
Columns are sortable. Click a column header to sort ascending or descending.
Screenshot pending
/help/promotions/filter_bar_expanded.png
Promotions filter bar with Status dropdown open, Connector dropdown visible, a date-range picker, and a search input
See docs/help-screenshot-manifest.md for capture instructions.
Promotion detail page
Click any promotion row to open its detail page. Here you can see:
- Source content — the original text or URL used as the source.
- Per-target rows — one row per channel showing status, posted URL (when successful), and error message (when failed).
- Retry button — on any failed target, click Retry to attempt that single channel again without re-running the successful ones.
- Execution log — expand a target row to see the full log: request payload (credentials redacted), response, attempt number, and duration in milliseconds.
Screenshot pending
/help/promotions/promotion_detail_page.png
Promotion detail page with the source content at the top, per-target table below with status pills, posted URLs, and Retry buttons on failed rows
See docs/help-screenshot-manifest.md for capture instructions.
Screenshot pending
/help/promotions/target_execution_log_expanded.png
A target row expanded to show the full execution log with request payload, response body, attempt number, and duration
See docs/help-screenshot-manifest.md for capture instructions.
Cloning a promotion
On the promotion detail page, click Clone. A new draft promotion is created with the same source content and the same channel selection. Open the Composer to edit it before publishing.
Cancelling a promotion
You can cancel a promotion that is in Draft, Scheduled, or Publishing status. Click Cancel on the detail page. Targets that have already posted cannot be un-posted — only pending targets are stopped.
Exporting to CSV
Click Export CSV on the Promotions list to download the currently filtered set (up to 10,000 rows). The export includes: promotion ID, reference ID, status, source type, created date, scheduled date, and all per-target columns (connector, channel, status, posted URL, error).
Screenshot pending
/help/promotions/export_csv_button.png
Promotions list header with the Export CSV button visible next to the filter bar
See docs/help-screenshot-manifest.md for capture instructions.