Showcases¶
A showcase turns a folder into a public page: a grid of every video in the folder and all its subfolders, with an inline player, at a stable link you can share. Filing a video under the folder is what puts it on the page — there is no separate list to maintain, and moving a video out of the folder removes it from the page instantly.
Enabling a showcase¶
Open a folder on the Videos page and click the screen icon next to the folder's name (or open Showcases in the sidebar to see every showcase in the project). Each folder has at most one showcase; the first visit offers a Create showcase button, and the showcase starts disabled so you can set everything up before going live. Flip Showcase enabled and the page is live at its link, of the form /s/<project_id>/<showcase_id>/.
The page always covers the folder's whole subtree. Nested folders can each have their own showcase — a subfolder's videos then appear on both pages, independently.
Privacy¶
- Public — anyone can open the page, and search engines may index it. The page emits structured data (an
ItemList) and social-share tags. - Unlisted (the default) — anyone with the link; search engines are told not to index it.
- Password — viewers must enter the showcase's password once per browser session. Logged-in members of the project skip the password. Note that viewers who unlocked the page keep access until their browser session expires, even if you rotate the password.
Deleting the folder (Recently deleted) takes the showcase offline immediately; restoring the folder brings the page back unchanged. A disabled or unavailable showcase shows a neutral "not available" page that reveals nothing.
Private videos¶
By default the page shows only public, ready videos — filing a private video under a published folder never exposes it. If you flip Also show private videos, the page embeds every private video in the subtree through short-lived signed links. Treat that switch with care: anyone who can open the showcase can watch every private video under the folder while the page is open.
Appearance¶
The page uses the showcase title (the folder title if you leave it empty), the description, the sort order (newest, oldest, or by title), and an optional accent color (a 6-digit hex value) for links and highlights. Viewers click a tile to play it in the inline player at the top of the page — ?v=<video_id> in the URL selects it, so you can link straight to a video on the page.
Branding¶
The Branding images card on the settings page carries the page's brand:
- Logo — shown 40px tall in the header; give it a click-through link (an absolute
http(s)URL) and the logo becomes your way home. Up to 1 MB. - Hero banner — a full-width image above the title. Up to 5 MB, stored at up to 2400px wide.
- Favicon — the browser-tab icon, normalized to 64×64. Up to 256 KB.
- Social share image — the link-preview image on social shares (1200×630 recommended); without one, the first video's poster is used. Up to 5 MB.
Every image is converted to PNG on upload and never enlarged; SVG is not accepted. Two more knobs live beside them: a plain-text footer line (a legal notice, a credit), and a featured video — the video that plays when the page is opened without a selection. A featured video that later leaves the folder is simply ignored until you pick a new one.
Finding videos on the page¶
A search box sits above the grid: viewers type a word and get every video in the showcase whose title or description contains it, in the page's sort order. The search is literal (no wildcards) and works without JavaScript — it's a plain form submit, so it composes with everything else on the page.
Sections mirror your subfolders¶
When the showcase's folder has subfolders, the page organizes itself: the folder's own videos come first, then one section per subfolder, in alphabetical order, each titled with the folder's name. A deeper subfolder's videos roll up into its top-level section — there is only one heading level — and empty sections are skipped. There is no toggle: file videos into subfolders and the page reflects them; keep everything in one folder and the page stays a flat grid. Search results always render flat.
Analytics and API¶
Plays on a showcase count in statistics exactly like any embed, and the folder's analytics already roll up the subtree — there is nothing new to configure. Showcases are a dashboard feature: there is no showcase REST API yet.