We’re glad to have you here.
JoomFlix Safe Video Documentation
Official documentation for JoomFlix SafeVideo — setup instructions, supported providers, configuration options and best practices for secure video embedding in Joomla 5.
Meet Safe Video — Clean. Secure. Effortless.
The safest way to embed YouTube, Vimeo, TikTok & Local videos in Joomla — privacy-first, fast and beautifully responsive.
Youtube videos
Vimeo videos
Dailymotion videos
Local videos
Facebook videos
Tiktok videos
JoomFlix Safe Video v1.0.0
Secure & Responsive Video Embedding for Joomla 5
JoomFlix Safe Video is a lightweight, secure and fully responsive video embedding module for Joomla 5. It supports YouTube, Vimeo, Facebook, TikTok, Dailymotion and local MP4 / WebM files, ensuring consistent output without exposing your site to unsafe iframes or third-party scripts.
Designed with a strong focus on security, performance and flexibility, Safe Video is ideal for e-commerce stores, landing pages, corporate websites and modern Joomla installations.
Key Features
Secure Video Output
Sanitized and sandboxed embeds to protect your site from untrusted sources.
Multiple Providers
YouTube, Vimeo, Facebook, TikTok, Dailymotion and local media files.
Fully Responsive
Automatic scaling with five built-in aspect ratio presets.
- Playback controls — autoplay, mute, loop, controls toggle
- Privacy mode for YouTube & Vimeo tracking protection
- Zero JavaScript dependencies — ultra-light CSS-based layout
- Clean backend UI with image-based provider selector
- 12 languages included (frontend & backend)
Video Structured Data (SEO)
JoomFlix Safe Video automatically generates Google-compliant VideoObject structured data for every embedded video.
This allows search engines to clearly understand your video content and makes your pages eligible for Video rich results, improved indexing and enhanced visibility in Google Search.
What data is generated automatically?
- Video title & description (from module settings)
- Upload date (ISO 8601 compliant)
- Thumbnail URL (auto or manual when required)
- Embed URL & content URL
- Provider-aware output (YouTube, Vimeo, Local, Facebook, TikTok)
Structured Data Example
Below is an example of the JSON-LD structured data automatically generated by JoomFlix Safe Video:
{"@context"}: "https://schema.org",
"@type": "VideoObject",
"name": "JoomFlix SafeVideo (Secure Video Embed)",
"description": "A secure and lightweight video embedding module for Joomla.",
"uploadDate": "2025-11-28T00:00:00+00:00",
"thumbnailUrl": "https://example.com/video-thumbnail.jpg",
"embedUrl": "https://www.youtube-nocookie.com/embed/VIDEO_ID",
"contentUrl": "https://www.youtube.com/watch?v=VIDEO_ID"
Installation
- Install pkg_safevideo.zip
- Go to Extensions → Modules → JoomFlix Safe Video
- Publish the module and assign it to a position
- Optionally embed it inside SP Page Builder using the Joomla Module addon
The module installs Image Selector Helper (
plg_system_jfimageselector) automatically.
This plugin powers the provider icon selector and must remain enabled.
Configuration Overview
Video Provider
Select the desired provider and paste the corresponding video URL or choose a local file.
- YouTube
- Vimeo
- TikTok
- Dailymotion
- Local media (MP4, WebM, OGV)
Size & Aspect Ratio
Choose how the video behaves across all screen sizes.
- 16:9 — Widescreen
- 4:3 — Standard
- 21:9 — Ultra-wide
- 9:16 — Vertical mobile
- 1:1 — Square
Playback Options
Fine-tune the viewing experience.
- Autoplay
- Show / hide controls
- Loop & mute
- Privacy mode for supported providers
- Preload control for local videos
Multilingual Support (12 Languages)
Fully translated frontend and backend language files are included.
Update Server
https://www.joomflix.com/update-server/updates/safevideo.xml
Included in the Package
- Main Safe Video module
- Image Selector Helper plugin
- 12 language packs
- Update server integration
Conclusion
JoomFlix Safe Video delivers a secure, modern and flexible video embedding solution for Joomla 5 — perfectly aligned with performance, privacy and responsive design best practices.
Developed by JoomFlix — Smart extensions for modern Joomla sites.
