Videos
Videos are embeddable video content that belongs to a publication. Each video is linked to a player platform, has a thumbnail, and can include written content above and below the player. Videos support Tags and drag-and-drop ranking for controlling display order on your website.
Navigate to Content → Videos
Supported Platforms
OptiPub supports three video platforms. The platform you choose determines which fields are required and what thumbnail options are available.
| Platform | Source | Thumbnail options |
|---|---|---|
| Wistia | Choose an existing Wistia video or upload a new one | Video (animated GIF) or static image |
| YouTube | YouTube video ID (11 characters) | Static image only |
| Video.js | Direct MP4 URL (WEBM optional) | Static image only |
Wistia is the recommended platform. It supports richer thumbnail options and provides engagement analytics directly in OptiPub.
Creating a Video
Click the Create button to open the video form. The form is organized into sequential sections.
Publication
| Field | Required | Description |
|---|---|---|
| Publication | Yes | The publication this video belongs to. Cannot be changed after creation |
Video Details
| Field | Required | Description |
|---|---|---|
| Title | Yes | The video title |
| Name | Yes | An internal name for the video |
| URL Slug | No | A custom URL slug. Auto-generated from the title if left blank |
| Displays on Website | No | Whether the video is shown on the public website |
| Active | No | Whether the video is live. Inactive videos are excluded from the website |
| Tags | No | Attach Tags to organize videos alongside other content |
Video Player
Choose a platform and provide the video source.
Wistia
Wistia videos can be added in two ways:
- Choose Existing — search and select from your Wistia library. You can filter by folder to narrow results
- Upload New — upload a video file directly to Wistia. Optionally choose a destination folder and custom video name (defaults to the filename)
If your Wistia account is not yet connected, a warning will appear with a link to Integration Settings where you can configure the connection.
YouTube
| Field | Required | Description |
|---|---|---|
| Video ID | Yes | The YouTube video ID — exactly 11 characters (e.g. dQw4w9WgXcQ) |
Video.js
| Field | Required | Description |
|---|---|---|
| MP4 URL | Yes | Direct URL to the MP4 video file |
| WEBM URL | No | Direct URL to a WEBM version of the video |
Thumbnail Image
| Field | Required | Description |
|---|---|---|
| Thumbnail Image | Yes | A static image used as the video's primary thumbnail. Selected from Assets |
YouTube and Wistia videos automatically import a default thumbnail from the platform when selected.
Video Thumbnail Configuration
After selecting a platform and video source, additional thumbnail settings become available. These control how the video thumbnail appears on your website and in emails.
Thumbnail Mode
- Video — generates an animated GIF clip from the video. Only available for Wistia videos
- Image — uses a static image thumbnail. Available for all platforms
The thumbnail preview has two tabs:
- Web — shows how the thumbnail will appear on the website
- Email — shows how the thumbnail will appear in email content
Play Button
You can overlay a play button on the thumbnail:
| Setting | Description |
|---|---|
| Play Button | Toggle to show or hide a play button overlay on the thumbnail |
| Color | The play button color. Defaults to the publication's primary color |
Clip Settings (Video mode only)
When using Video thumbnail mode with a Wistia video, you can configure the animated GIF clip:
| Setting | Description |
|---|---|
| Duration | Length of the GIF clip — 5, 10, or 15 seconds |
| Start | The starting point in the video (in seconds) |
After configuring clip settings, click Generate Thumbnails to create the animated GIF and still image. If you change settings later, click Regenerate Thumbnails to update them.
Content
| Field | Required | Description |
|---|---|---|
| Top Blurb | No | Rich text content displayed above the video on the website (TinyMCE editor) |
| Bottom Blurb | No | Rich text content displayed below the video on the website (TinyMCE editor) |
Video Ranking
When a video is both Active and Displays on Website, a ranking section appears at the bottom of the form. Drag and drop videos to set the order they appear on your website relative to other videos in the same publication.
Ranks are shared across all active, website-visible videos in the publication, so reordering one video updates the rank for all of them.
Editing a Video
Click on any video in the list to view it, then click Edit to make changes. All fields except Publication can be updated. The form supports auto-save, which periodically saves unsaved changes.
List View
The video list displays all videos across publications in a searchable, filterable data table. The following columns are available:
| Column | Filter type | Default |
|---|---|---|
| ID | Number | Shown |
| Publication | Select | Shown |
| Title | Text search | Shown |
| Name | Text search | Shown |
| Video Player | Text search | Hidden |
| Thumbnail | — | Shown |
| Email Video Thumbnail | — | Hidden |
| Email Image Thumbnail | — | Hidden |
| Tags | Select | Shown |
| Rank | Number | Hidden |
| Active | Boolean | Shown |
| Display on Website | Boolean | Shown |
| Created | Date | Hidden |
| Updated | Date | Hidden |
View Mode
Clicking a video row opens a view dialog with two tabs:
- Video — displays tags, name, top blurb, an embedded video player, and bottom blurb
- Stats — displays engagement analytics (only available for Wistia videos with recorded data)
Wistia Analytics
For Wistia videos, OptiPub automatically fetches and stores engagement data from the Wistia API. The Stats tab in the view dialog shows:
- Total Visitors
- Average Engagement
- Total Plays
- Play Rate
- An engagement and rewatch chart over time
Statistics are updated daily via a scheduled task.
Dynamic Video Pages
Videos can be used with dynamic pages. By setting a page path to {$sys_video.slug}, OptiPub generates an individual page for each video. Inside the page content, use system macros like {$sys_video.title} to render video data dynamically.
Updated 1 day ago