Content library
Manage articles, videos, scripts, policies, and announcements surfaced to merchants and other apps.
Narrow which items appear in the table below. These do not change content when you add or edit.
| Title | Type | Category | Translations | Updated | Actions |
|---|
| Title | Translations | Status | Audience | Published | Duration | Items | Expires | Updated | Actions |
|---|
New content
Add a title, type, and category for this content item.
New announcement
Group content items into a timed announcement bundle.
Announcement title (English)
How content management works
Overview
The content library has two layers:
- Content items — authored assets (articles, avatar videos, scripts, policies). You write and translate these on the edit page.
- Announcements — timed bundles that group one or more content items and control when and who sees them in merchant apps.
Create content
Edit EN/ES
Build announcement
Add & order items
Publish
Worker syncs
Merchant app
Step 1 — Create content items
- Open the Content items tab and click +.
- Enter an English title, choose a type and category (
new,improved, orfixed), then save. - You are redirected to the edit page. Use the EN / ES toggle to add translations.
- Fill in the summary and type-specific fields:
- Article, policy, announcement — TipTap rich text body
- Script — plain textarea
- Avatar video — video URL (use Browse S3 to pick from
viasite-videos/ops/via-features/)
Note: Content items are building blocks only. Per-item status and audience are not set in this UI — publishing to merchants is done through announcement bundles.
Step 2 — Create an announcement bundle
Switch to the Announcements tab and click +. Key fields:
| Field | Purpose |
|---|---|
| Title | Bundle headline shown to merchants. Use the EN / ES toggle to enter English and Spanish titles (English required). |
| Status | draft = work in progress; published = live or scheduled; archived = retired. |
| Audience | merchant_app or all apps. |
| Publication date | When the bundle becomes eligible to go live. |
| Duration (days) | How long the bundle stays active after the publication date (minimum 1). |
Step 3 — Associate content with an announcement
- In the announcement modal, use the Content items picker: select an item and click Add.
- Reorder items with the up/down arrows. The list order is the order merchants see items in the bundle.
- Remove items with the delete button on each row.
- At least one content item is required to publish an announcement.
Step 4 — Publishing and lifecycle
- Publish now: set Status to Published, set Publication date (now or future), Duration ≥ 1, add items, then save.
- Schedule for later: keep Status as Draft with a future Publication date. A daily worker promotes it to Published when the date arrives.
- Expires at = Publication date + Duration days (shown in the announcements table).
- Active window: the bundle is active when status is published and the current time is between the publication date and expires at.
- After expiry: the daily worker archives the bundle (status
archived, no longer active).
Publication worker: runs once per day inside viaconsole to sync status transitions and active flags. Saving an announcement also recalculates expiry immediately on create/update.
Step 5 — What merchants see
- The merchant app calls
GET /api/announcements/active(viaconsole_api.getActiveAnnouncement). - Returns the current active bundle for the
merchant_appaudience (including bundles set toall), ornullif none is active. - The
items[]array includes each content item’s title, category, summary, video URL, and other fields. - Pass
?locale=es(oren) for localized bundle title and item fields.
Tips
- Create and edit content items before building the announcement bundle.
- Category on content items drives the New / Improved / Fixed badges merchants see.
- List filters only affect the table view — they do not change create/edit defaults.
- Editing a published announcement’s duration recalculates the expiry date on save.
