Customization

Display a video in a popup or lightbox

A popup embed opens the player over the current page when the viewer selects a thumbnail, text link, or supported custom trigger.

Configure the popup

  • Open Galleries and select Customize Gallery.
  • Enable Video Popup where the template provides it, then save the settings.
  • Open the gallery's Embed panel and choose Popup.
  • Select the offered trigger format, copy the complete generated code, and add it to your website.

The available popup behavior depends on the template and embed method. Use gallery customization to select a suitable layout.

Choose a thumbnail or text trigger

Video Thumbnail displays an image that opens the player on click. Choose a responsive container or a fixed size as appropriate for the page, and check the result on mobile.

Text displays a link that opens the popup. Set descriptive popup link text, such as Watch the setup walkthrough, so the viewer knows what will open.

These options consolidate the older popup-type embed instructions. Use the generated snippet rather than copying markup from an unrelated gallery.

Use a custom JavaScript trigger

For a supported, initialized Cincopa gallery, the runtime exposes cincopa.getGalleryById(id).startPopupSkin(). Pass the actual gallery or container ID for the embedded instance.

To request a specific asset, the method accepts its asset ID: startPopupSkin(ASSET_RID). Call the method from a click handler after the gallery is initialized. Do not use example gallery or asset IDs in production.

The Developer Center embed guide provides popup and standard embedding examples. A custom trigger requires the Cincopa runtime and a compatible gallery; a text link alone does not load a player.

Test the popup

Test opening and closing with mouse and keyboard, confirm focus remains usable, and check small screens. Avoid placing the trigger where page overlays cover it. If the popup fails, compare the generated embed with your page's code and check for script restrictions or incorrect IDs.

See Embed and Share for regular and iframe alternatives. Popup behavior and floating playback serve different purposes.