Skip to content

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.

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.

On a page with a video, the head gains:

  • og:video, the address of the video
  • og:video:secure_url, the same address, on sites served over HTTPS
  • og:video:type, video/mp4 or video/webm
  • og:video:width and og:video:height, measured from the video when you upload it

Your Open Graph image, title and description are untouched.

  • PageMotor 0.11.5 or later
  • EP Suite base class
  1. ep-og-video.zip comes with an EP Suite licence. ElmsPark supplies it directly (see EP Suite plugins); after install it updates through your site’s Updates screen.
  2. Upload via Plugins → Manage Plugins. Activate.
  3. 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.
  1. Open the page in the editor.
  2. Find EP OG Video in the page’s options, just below Open Graph.
  3. 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.

  • 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 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.

EP OG Video registers three actions, available to producer and admin agents over the PageMotor API and MCP:

ActionWhat it does
upload-videoHosts 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-headPuts the plugin back in the theme’s head, straight after Open Graph. Use it after switching theme.
statusReports 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.

There are no settings to configure. The settings screen explains how the plugin works.

”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.

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.

  • 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-video hosts a video sent as base64, place-in-head puts the plugin back in the head after a theme change, and status reports where it sits.
  • Translated into Danish, Dutch, French, German, Italian, Portuguese and Spanish.
  • Needs PageMotor 0.11.5.