• screenshot

    Browse, select and import videos directly from your Vimeo account.

  • screenshot

    Videos are rendered using Vimeo's HTML5 video player with configurable options.

Vimeo Import imports videos from Vimeo to the Koken Library. Imported videos look, feel and function just like any other Library asset and are published to your Koken web site just the same. The plugin enhances Koken's site publishing for creatives who'd like to publish demo reels, behind-the-scenes videos, short films, or other types of video content to complete their portfolio of work.

Easy importing

Enter your Vimeo username and the plugin returns a list of all your videos. Scroll to the video or videos you want, click to select, then hit Import. Titles, captions, tags and preview images are imported and assigned automatically along with the video.

Vimeo HTML5 player

Imported videos are rendered using the Vimeo player so your original video files stay at Vimeo. This keeps hefty video files off your personal server and allows imported videos to retain their Vimeo context and functionality (Like, Share, Watch it Later, Purchase, etc). All editable options for Vimeo's excellent HTML5 player are provided, including playback, color and title overlays.

Mix with other Library content

Organize and publish your Vimeo videos however you please. Get creative with albums of uploaded images, Vimeo videos, then publish as complete collections to your Koken site.

Compatible with any site theme

This plugin leverages Koken's Lens image/video template tags to ensure compatibility with any theme. That means you can start importing and publishing Vimeo videos without any modifications to your theme or templates. Videos render using Vimeo's player or as preview images wherever appropriate (lightbox included).

Demonstration video

See the Vimeo Import plugin up-close and in-action in this demonstration video.

Next: Setup

Follow the steps below to begin using the Vimeo Import plugin.

Enabling the plugin

After the plugin has successfully downloaded and installed you will be redirected to Settings > Plugins inside Koken. Click the plugin's Enable button to activate the plugin.


While you're there you should click on Setup to check out the plugin's default settings. The settings assigned here are applied to every video you import from Vimeo, so it's a good idea to check out the defaults before you begin importing.

Vimeo plugin settings

Here's a rundown for each available setting.

  • Name - This is your account name at Vimeo. You may find your name at Vimeo.com through My Settings > Account.
  • Assign "vimeo" tag to all imported videos (Default: Off) - Automatically assigns a "vimeo" tag to everything imported from Vimeo. Handy for viewing all imported Vimeo videos on your site.
  • Assign tags from Vimeo (Default: Off) - Automatically creates and assigns tags to match your Vimeo tags.
  • Vimeo player settings (Defaults: Text, Autoplay and Loop all off. Color is Vimeo's default blue) - Vimeo's video player includes a number of editable options to show/hide titles at the beginning of the video, interface color, etc. All available options are presented here and serve as the defaults for all published videos. You may override these values by applying different player properties to Vimeo videos in the Library.

Next: Importing

Now let's get to the fun part -- importing videos! Click on Library in Koken's main navigation, then the Import content button at bottom right. Click on the Vimeo button icon (shown below).

Vimeo import button

If you didn't enter a Vimeo account name on the plugin setup screen, no worries. You can enter your name here too. After doing so click the Connect button. The plugin will then retrieve all the latest videos uploaded to your Vimeo account. Any videos you've already imported to Koken are automatically hidden.

Vimeo latest upload list

Single-click on each video you'd like to import. When finished click the Import button. Koken will import the video(s) to your Library.

Importing a video by URL

You may also import videos using their Vimeo.com page URL. Click on the "page url" link (see screenshot above) and a input labeled Video URL will appear. Open a separate browser window/tab, navigate to the video you want to import at Vimeo.com, copy the page URL from the browser's location bar, then return to Koken and paste into the field provided. Click Import and the video will be imported just the same.

Pasting video page URL into field

You'll then see an input where you may paste the URL you just copied. Then press Import to pull the video in.

Browsing Vimeo videos

After you've imported your first video a new Vimeo imports option will appear in the Library's left column. The plugin provides this so you have a handy place to browse and edit everything you've imported from Vimeo.

Vimeo imports

Editing video properties

Select any imported video and the right Inspector column will display its properties. At the top is a mini-player displaying the video followed by a source link underneath. This links to the video's page at vimeo.com (which can also be published to your site, should your theme support it). Undereath that are the video's Title and Caption, both imported automatically from Vimeo.

Vimeo properties

Tags may also be populated with the video's tags from Vimeo, but that's turned off by default. If you'd like to include them when importing, head over to the plugin's Setup screen (Settings > Plugins) and check the appropriate box. You will also have the option of assigning "vimeo" as a tag automatically if you'd like to include that.

Editing video player

Vimeo's player offers a handful of editable options to control its appearance. You may customize these settings (color, titles, etc) for all imported videos through the plugin's setup screen or override those default values by applying setitngs individually in the Library. You can find those settings by selecting an imported video in the Library then scrolling to the bottom of the Inspector panel.

Vimeo player properties

Protecting your videos

Since your videos are now embedded outside of Vimeo.com we should mention Vimeo's domain-level privacy. If you have a Vimeo Plus or PRO account you may dictate where your videos may be embedded so only your Koken site is allowed to display them (in addition to Vimeo.com, of course). If that's of interest to you we recommend reading up on Vimeo's Privacy Settings.

(Note: We're in no way affiliated with Jamie Roberts or Max Smith, our example Vimeo content. We just like their work, so check them out.)

Next: Publishing

Imported Vimeo videos look, feel and function like any other Library asset. You may assign tags, categories, captions, as well as group your Vimeo videos together with or without images using albums.

Content index and timeline

Import an video from Vimeo and it will immediately appear on your web site's content and timeline pages. Regardless of when the video was published at Vimeo it will be treated as "new" and published to the top of these calendar-based templates. The date the video was originally published to Vimeo is assigned to the video's Captured date. If you want a Vimeo video to be published on the day it was published to Vimeo, select the video in the Library, edit Published in the right column, then check the Assign date captured option. The video will then appear on your site using the same date from Vimeo.

If you always want your imported videos to be published using the Vimeo date, go to Settings > Importing in Koken and check the Assign date captured to date published option.

Publishing an album

Vimeo videos are handled like any other Library asset, so if you'd like to publish an album of them, click the plus (+) button at the bottom left of the Library. Create an album, then click on Vimeo imports in the left column. Drag videos from here onto the album you just added in the left column.

Once created the album will appear on your site's Albums index page. You may also add the album to your site's navigation by clicking on Add links in the left column of Site.

Publishing an index

If your theme includes a Contents template (which nearly all do), Vimeo Import adds an "Vimeo" template to Site. Click Add links in the left column and you'll see this:

Vimeo template

Click Add, then name the page. You may also fine-tune the page display options underneath. Koken will duplicate your theme's Contents template and display all your imported Vimeo videos sorted by recency.

Next: Disabling

If the Vimeo Import plugin is disabled and your Library contains imported videos from Vimeo, those videos will not be affected. They will remain part of your Library and site. You will however need to re-enable the plugin in order to import videos from Vimeo again.

Version 1.1.9 Released 3 years ago

  • Use the latest Vimeo JavaScript API on published sites.
  • Allow imported videos to scale up to their original size.

Version 1.1.8 Released 4 years ago

  • Fixes to workaround changes in the Vimeo API that caused some imports to fail.

Version 1.1.7 Released 4 years ago

  • Fixed issue that caused some vimeo embeds to show up as HTML code.

Version 1.1.5 Released 5 years ago

  • Interface updates.

Version 1.1.6 Released 5 years ago

  • Progress notifications when connecting to Vimeo.

Version 1.1.4 Released 5 years ago

  • Fixed issue that prevented editing options for individual videos.

Version 1.1.3 Released 5 years ago

  • Fixes related to Koken 0.17.

Version 1.1.2 Released 5 years ago

  • Resolve playback issues in Pulse slideshows on iOS.
  • Fixes for Koken 0.16.

Version 1.1.1 Released 5 years ago

  • Updates for new visibility changes in Koken 0.14.

Version 1.1.0 Released 5 years ago

  • Filtered template for displaying just your Vimeo content in any theme (Koken 0.13.1+ required).
  • Import sheet design improvements.

Version 1.0.1 Released 5 years ago

  • Videos with their embed privacy set to "Nowhere" are no longer shown in the list of available videos to import.
  • Fixed autoplay not working properly in Pulse slideshows.