• Home
    • Pugpig Bolt
    • Content and Workflows
    • Video

    Vertical video and Clips

    Written by Benji Weiser

    Updated at July 28th, 2026

    • Pugpig Bolt

      • Pugpig Site

        • Pugpig Archive

          • Working with Pugpig

            • Pugpig Consulting

              Table of Contents

              What is vertical video? Clips Video carousels Who can use our vertical video features? Clips and Carousels together What is needed to get it live? Clips Orientation Carousels Analytics

              What is vertical video?

              With the rise in popularity of video content on mobile devices via platforms, such as Tiktok, Youtube (shorts) and Instagram has come an increase in mobile-first videos, videos made for mobile screen dimensions that are portrait rather than landscape.

              Traditionally video content in news apps and Bolt apps has been in a landscape format, but as demand grows we've been looking at ways to support portrait formats in our apps.

              Clips

              Clips is Pugpig Bolt's TikTok-style vertical video experience. It gives users a dedicated, full-screen vertical feed of short-form videos they can swipe through, separate from the main article timeline.

              Videos autoplay as users swipe up and down. The player supports pause/play, mute/unmute, descriptions, titles, auto-advance, and looping.

              Video carousels

              Vertical video carousel

              We also support vertical video carousels. These allow you to present your vertical videos in a horizontally scrollable format for users to browse. You can have as many carousels as you want in a timeline and as many videos as you want in a carousel.

              When a user taps on a video in a carousel it will open full screen, as expected for this format, apart from MP4 videos due to OS limitations.

              Who can use our vertical video features?

              Support depends on your chosen video provider.

              Our supported providers for Clips are currently:

              1. Youtube
              2. JWplayer
              3. MP4

              Our supported providers for vertical video carousels are all of the above plus:

              1. Brightcove
              2. Vimeo
              3. M3U8

              Note that for carousels some providers may behave differently than others. MP4s will always play inline rather than opening straight to full screen.

              Clips and Carousels together

              Note that Clips and Carousels are currently separate features. It is absolutely our intention to combine the two so that when a user taps into a carousel they are taken to Clips and can swipe to the next video, so stay tuned!

              Advertising in Clips

              Clips supports advertising within the vertical feed, so you can monetise the format alongside your editorial video.

              How it works

              Clips can inject an iframe into the feed every x videos. The ad sits in the feed as a full-screen slide, just like a video, and the reader swipes into it as they scroll through. Because the slot accepts any iframe URL, you can serve whatever creative you like, including ads from Google Ad Manager (GAM).

              Serving Google Ad Manager (GAM) ads

              There is currently no direct GAM ad unit integration in Clips, so GAM ads are served through the iframe slot. The typical flow is:

              1. Build your GAM ad as a self-contained HTML page (for example, an HTML zip containing your GAM tag).
              2. Host that page at a URL.
              3. Point the Clips ad slot at that URL in your app configuration in Pugpig Distribution.

              Supporting GAM ad units natively, rather than via an iframe URL, is something we are considering. If that would be valuable for your setup, please let your Customer Success Manager know.

              Configuration options

              The following options are available on the Clips ad slot:

              Option Description
              Ad URL The URL loaded into the iframe, i.e. the ad creative you want to serve.
              Frequency How often an ad is injected into the feed, e.g. one ad every x videos.
              Title The title shown to the reader on the ad slide.
              Skip delay How long to wait before the skip button appears, allowing the reader to move past the ad.

              These options live in the Clips configuration in Pugpig Distribution. Reach out to our Support team or your Customer Success Manager and we can get them set up for you.

              Ad reporting

              Ad impressions and skips are tracked automatically. See BoltClipsAdView and BoltClipsAdSkip in the Analytics section below.

              What is needed to get it live?

              Clips

              Clips ships as part of Bolt Timeline 5.15.0. For Clips to work correctly, the following native app versions are required:

              • iOS 4.22.8 or later
              • Android 5.1.6 or later

              Both versions include the new universal analytics bridge with native support for feed and story dimensions (to allow correct Clips analytics) AND the ability to hide the audio miniplayer on Clips type tab.

              Please reach out to us if you're interested, Clips is its own tab so will need configuration from our Support team.

              Orientation

              1. Go to a video card by going to Content > Video Cards.
              2. Click “Add video card” or edit one of your choice and change the “orientation” field.
              3. Publish.

              If your video cards are added via a feed, you can add a new field to each item to set the orientation. The field can be called anything you like as long as it contains either of:

              1. landscape
              2. portrait

              Then let our team know and we can map the new field for you.

              Carousels

              This will depend on your CMS setup and will need a bit of setup so reach out to your Customer Success manager if you're interested. If you'd like carousels to be automatically populated and update regularly we'll need to enable our Timeline Layouts feature for the timeline containing the carousel.

              If you want manual control, or just want to test the appearance, then you need to add a carousel card to a timeline, select the ‘video’ style, and put in whichever videos you like. Note that manual carousels can contain both portrait and landscape video cards, but putting a mix of the two into one carousel will look very poor.

              Analytics

              Clips tracks video events automatically via the analytics bridge. The following events are fired:

              Event Description Triggered when
              BoltClipsVideoPlay Video playback started User plays a video (manual, swipe, loop, or auto-advance)
              BoltClipsVideoPause Video playback paused User manually pauses a video
              BoltClipsVideoEnded Video playback ended Video reaches the end
              BoltClipsAdView Ad viewed Ad becomes visible to the user
              BoltClipsAdSkip Ad skipped User clicks the skip button on an ad

              Each event includes the following dimensions:

              Dimension Description
              pugpigVideoElapsedSeconds Current playback time in seconds
              pugpigVideoTotalSeconds Total video duration in seconds
              pugpigEventOrigin Always "Clips"
              pugpigVideoTransition How play was triggered: Initial Load, Manual Swipe, Loop, or Auto-Advance
              pugpigVideoPlaybackSpeed Playback speed: 1 (normal) or 2 (2x)
              video orientation portrait video vertical video

              Was this article helpful?

              Yes
              No
              Give feedback about this article

              Related Articles

              • Persistent video player
              pugpig logo white
              Navigation
              • Products
              • Customers
              • News
              • Podcast
              Contact
              • Contact us
              • LinkedIn
              • Twitter
              Technical Support
              • Status Page
              • Documentation
              • Customer Support
              Corporate
              • Company
              • Jobs
              • Privacy Policy

              © Kaldor Ltd. 2022

              Powered by Pugpig


              Knowledge Base Software powered by Helpjuice

              Expand