EP OG Video
EP OG Video gives any page on your PageMotor site a short looping video for its link preview. Apps that play link previews, such as Discord, show the video when someone shares the page. Everywhere else, people see the page’s Open Graph image as usual.
Published by ElmsPark Studio.
Overview
Section titled “Overview”When you share a link, the app you share it in reads a few tags from the page’s head to build the preview card. The title, the description and the image are the familiar ones. There is also a tag for a video, og:video, which some apps play in place of the still image.
EP OG Video adds that tag, and the four that go with it, to any page that has a video. Pages without one are left exactly as PageMotor renders them.
It does not change the page type. A page with a moving preview still tells apps it is a website or an article, so a link shared in Discourse and similar forums keeps its normal card, with a title that opens the page.
What it adds
Section titled “What it adds”On a page with a video, the head gains:
og:video, the address of the videoog:video:secure_url, the same address, on sites served over HTTPSog:video:type,video/mp4orvideo/webmog:video:widthandog:video:height, measured from the video when you upload it
Your Open Graph image, title and description are untouched.
Requirements
Section titled “Requirements”- PageMotor 0.11.5 or later
- EP Suite base class
Installation
Section titled “Installation”ep-og-video.zipcomes with an EP Suite licence. ElmsPark supplies it directly (see EP Suite plugins); after install it updates through your site’s Updates screen.- Upload via Plugins → Manage Plugins. Activate.
- That is all. The first time the plugin runs, it adds itself to your theme’s head, straight after Open Graph. It does this once for each theme you use.
Adding a moving preview to a page
Section titled “Adding a moving preview to a page”- Open the page in the editor.
- Find EP OG Video in the page’s options, just below Open Graph.
- Drop an MP4 or WebM into the upload box, then save the page.
Hosted html documents have the same option.
The upload box takes files up to 8 MB, but link previews work best with small files, so aim for under 2 MB.
Making a good preview video
Section titled “Making a good preview video”- Size: 1200 by 630 pixels, the same shape as an Open Graph image.
- Length: three to six seconds, made to loop with no visible jump.
- First frame: make it a complete picture. Most apps show only that frame, and some show it while the video loads.
- MP4 with “faststart”: the plugin reports whether your MP4 has it when you upload. It lets an app start playing before the whole file arrives.
Keep the page’s Open Graph image set as well. It is what most apps show, and what everyone sees where video is not played.
Discourse and other forums
Section titled “Discourse and other forums”Discourse ignores og:video for an ordinary link card, but it does keep GIF images moving. For movement there too, upload a GIF as the page’s Open Graph image (core’s Open Graph option), and keep the MP4 in EP OG Video for the apps that play video.
Discourse caches each link’s preview for about a day. To see a change on a post you have already made, use Rebuild HTML on that post.
For agents
Section titled “For agents”EP OG Video registers three actions, available to producer and admin agents over the PageMotor API and MCP:
| Action | What it does |
|---|---|
upload-video | Hosts an MP4 or WebM sent as base64 (up to 5 MB) and returns its address, size and faststart. It does not attach it to a page. |
place-in-head | Puts the plugin back in the theme’s head, straight after Open Graph. Use it after switching theme. |
status | Reports whether the plugin is in the head and where it sits. |
To attach a hosted video to a page, save the page with "EP_OG_Video": {"video": {"uploads": [{"url": "<address>"}]}}. A bare address string also works.
Settings
Section titled “Settings”There are no settings to configure. The settings screen explains how the plugin works.
Troubleshooting
Section titled “Troubleshooting””I uploaded a video but the page has no og:video tag”
Section titled “”I uploaded a video but the page has no og:video tag””The plugin has to be in your theme’s head. It adds itself the first time it runs on each theme, but if you switched theme or removed it from the head, run the place-in-head action, or check the plugin’s place in your theme’s HTML Head editor.
”Discord shows the still image, not the video”
Section titled “”Discord shows the still image, not the video””Discord caches previews. Share the link with something extra on the end, such as ?v=2, to make it fetch the page again. Also check that the video file opens on its own in a browser.
”The upload says the video is over 8 MB”
Section titled “”The upload says the video is over 8 MB””Make the file smaller. A few seconds at 1200 by 630 is usually well under 1 MB as an MP4.
Feedback and corrections
Section titled “Feedback and corrections”For a quick question about this plugin, EP Support inside your admin is the fastest option. The chat widget sits on every EP plugin settings page and knows which one you’re on, with starter questions and links preloaded for that exact screen.
For anything bigger, such as a bug report, a feature request, or a “how do I…” that needs a real reply, open a ticket at help.elmspark.com. A real person, helped by AI, writes the reply. Usually within a few hours.
Changelog
Section titled “Changelog”- Moving link previews. Give any page, or any hosted html document, a short MP4 or WebM loop. Apps that play link previews, such as Discord, show the video. Everywhere else the page’s Open Graph image stays the still preview.
- Upload on the page. Each page has a new EP OG Video option, just under Open Graph, where you drop the video.
- Sits in the right place by itself. The plugin adds itself to your theme’s head, straight after Open Graph, the first time it runs on each theme, so the video reaches every page that has one.
- Links keep working in forums. The plugin adds the video and leaves the page type alone, so a link shared in Discourse and similar forums still shows a normal card that opens the page. For movement there too, make the page’s Open Graph image a GIF.
- For agents. Three actions:
upload-videohosts a video sent as base64,place-in-headputs the plugin back in the head after a theme change, andstatusreports where it sits. - Translated into Danish, Dutch, French, German, Italian, Portuguese and Spanish.
- Needs PageMotor 0.11.5.