{"title":"vimeo - Liquid Filter Reference","slug":"vimeo-filter-reference","url":"https://support.storeconnect.com/articles/vimeo-filter-reference","url_markdown":"https://support.storeconnect.com/articles/vimeo-filter-reference.md","subtitle":null,"summary":"Generates responsive HTML embed code for a Vimeo video ID. Supports a `start_at` option to begin playback at a specific number of seconds.","type":"Developer_Documentation","video_url":"","keywords":"liquid, filters, vimeo, videos, storeconnect","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"| Filter Name | vimeo |\n| :---- | :---- |\n| **Group** | Videos |\n| **Version** | 1.2.3 |\n\nReturns HTML embed code for the supplied Vimeo id\n\n## **Examples**\n\n\n```\n{{ \"12345-abcde\" | vimeo }}\n```\n\n\nResult:\n\n```\n\u003cdiv class=\"responsive-iframe\"\u003e\u003ciframe src=\"https://player.vimeo.com/video/12345-abcde#t=0s\" frameborder=\"0\" allow=\"autoplay; fullscreen\" allowfullscreen class=\"Video_embed vimeo\"\u003e\u003c/iframe\u003e\u003c/div\u003e\n```\n\n### **Options**\n\nstart\\_at\n\n**Moves the playback starting position of the video forward by this number of seconds**\n\nWhen start\\_at is provided, it adjusts the embed code for the requested start time:\n\n\n```\n{{ \"12345-abcde\" | vimeo, start_at: 678 }}\n```\n\n\nResult:\n\n```\n\u003cdiv class=\"responsive-iframe\"\u003e\u003ciframe src=\"https://player.vimeo.com/video/12345-abcde#t=678s\" frameborder=\"0\" allow=\"autoplay; fullscreen\" allowfullscreen class=\"Video_embed vimeo\"\u003e\u003c/iframe\u003e\u003c/div\u003e\n```\n\n## **Using an unlisted Vimeo video**\n\nFor unlisted Vimeo videos, the embed needs to use the player URL format with the hash included as a query parameter.\n\nFor example\n\n\n```\n{{ \"1020379123?h=5e86c5f89b\" | vimeo }}\n```\n\n\nThe format is the video ID followed by the video reference hash as a second parameter. This ensures both are passed correctly to the Vimeo player.\n\nIf the video still doesn't load after using the correct format, try this troubleshooting step:\n\nIn Vimeo, go to Video Settings \\\u003e Privacy \\\u003e Where can this be embedded? and make sure the site's domain is added to the allowed/trusted domains list, or that embedding is set to \"Anywhere\". If the domain isn't on that list, Vimeo will block the embed regardless of whether the code is correct.\n\nAfter updating the privacy settings, refresh the page and test again.\n\n[Back to filter list](liquid-filters)"}