Tassos Marinos Developer of Joomla Extensions

ACF Video - Embed a YouTube, Vimeo, Facebook, Dailymotion, and Self-Hosted Video in Joomla

Updated 10 Aug, 2023

The "ACF - Video" custom field provides a versatile solution to seamlessly integrate videos from YouTube, Facebook, Vimeo, Dailymotion, and self-hosted videos into your Joomla site. This documentation will guide you through implementing and customizing the "ACF - Video" custom field on a per-provider basis, enabling you to enhance your website with engaging videos effortlessly.

How to add a Video Custom Field to Joomla! Articles

To use the "ACF - Video" custom field, create a new Joomla! custom field and select the "ACF - Video" type, as seen below.

acf video field settings

The Video Field Settings

Below, you can find a list of the available options of the Video Field.

acf video field settings

Video Width Set the video width for desktop/tablet and mobile devices.
Video Height Set the video height for desktop/tablet and mobile devices.
Autoplay Set whether to autoplay the video.
Autopause Set whether to pause the video whenever the user scrolls while the video is playing and the video hides from the viewport.
Fullscreen Set whether to allow the video into fullscreen mode.
Controls Set whether to display the video controls.
Loop Set whether to make the player will repeatedly play the video.
Mute Set whether to mute the video.
Disable Keyboard Shortcuts Set whether to make the player respond to keyboard shortcuts, such as managing the audio volume, pausing, playing, etc...
Start time Set the start time of the video in seconds.
End time Set the end time of the video in seconds.
Closed Captions Enable to make closed captions to be shown by default, even if the user has turned captions off.
Modest Branding Enable to prevent the YouTube logo from displaying in the control bar. Note that a small YouTube text label will still display in the upper-right corner of a paused video when the user's mouse pointer hovers over the player.
Related Videos Enable to show related videos when playback of the initial video ends.
Color Set the color that will be used in the player's video progress bar to highlight the amount of the video that the viewer has already seen.
Privacy-Enhanced Mode When you turn on privacy-enhanced mode, YouTube won't store information about visitors on your website unless they play the video.
Display Title Choose whether to display the video's title, only if the owner allows it.
Display Byline Choose to display the video's byline, only if the owner allows it.

The byline is everything that is displayed right under the title. On most occasions, it's the creator's username.
Display Portrait Choose to display the creator's portrait, only if the owner allows it.
Picture In Picture Enable to show the picture-in-picture button in the control bar.
UI Color Pick a color for the video's UI

This color will be used for the title, the byline and the player controls.
Privacy-Enhanced Mode When you turn on privacy-enhanced mode, YouTube won't store information about visitors on your website unless they play the video.
Include Post Enable to include any text from the Facebook post associated with the video. Only available for desktop sites.
Show Captions Enable to show captions (if available) by default. Captions are only available on desktop.
Preload Specifies if and how the video should be loaded when the page loads.
Cover Image
Cover Image Type Select the cover image type.

Available options:
  • No Cover Image
  • Auto (From video provider)
  • Custom
Select Cover Image Select a custom cover image.

Field Usage

Once in your Article's Edit screen, choose the "Fields" Tab to see the Video custom field as seen in the screenshot below.

acf video field usage

You will notice that once you enter a video URL, it will automatically display a preview of the video that will appear on your site, providing you with context.

Frontend Display

Take a look at the screenshot below to see how it could be displayed in your frontend.

acf video frontend display

Frequently Asked Questions

How can I override the layouts?

To override the "ACF - Video" custom field, read here: How to override the "ACF - Video" custom field.

WIll it affect my site's performance if I have multiple videos on the same page?

The "ACF - Video" custom field is built with performance in mind, meaning it won't load any video unless the visitor sees the video on their viewport as they scroll through your site. Only then will it start loading the video, ensuring optimal performance.

When I try to select a self-hosted video, I do not see any video-related files.

When the "Self-Hosted Video" provider is selected, the Joomla core media library is used to select a video. This means that the Global Configuration > Media settings are used to determine what videos will be available for you to select.

Can I use ACF - Video with YooTheme Pro Dynamic Content?

The "ACF - Video" custom field is YooTheme Pro compatible and can be used with Dynamic Content.