Videos
Use the Video component to embed a video on the page. If you are using external suppliers for video productions, you need to make sure they follow accessibility guidelines. This is of course just as important for internal video production.
Youtube video with manually added thumbnail image.
Best practise
- When linking to a video file (not embedded using the Video Component), include both the file format (e.g. .mp4) and file size (e.g. 25 MB) in the link text.
- This helps users understand what they are downloading and how large the file is.
- However, this solution is not optimal, as the user must download the video, which can take time if the file size is large. Whenever possible, use the Video Component instead.
Example:
- Add a Rich Text (RTE) component with a short description of what the video is about or include the video title.
- Place the text between the headline and the video component.
- Keep the text brief and informative (1–2 sentences).
Example:
Tjänstepension – trygghet för dina anställda
Bli en bättre arbetsgivare och skapa trygghet för dina anställda med tjänstepension. Med vår pensionsplan kan du också inkludera försäkringar om du vill.
Our general guideline for video length is 1-2 minutes, to keep attention high and deliver quick value for the viewers. Demos and tutorials can be a bit longer.
Recommendation by type of video:
- Product demos: 1-3 minutes
- Tutorials/how-to: 2-5 minutes
Make sure information is not conveyed with colours alone, and when colours are used, they are easily distinguishable.
When displaying text in the video, ensure the font size is large enough, and text is on the screen for long enough to read.
Flashing content in videos should be avoided. If flashing content must still be included, the video should not have more than three flashes within a period of one second, as this can provoke seizures in some users with seizure disorders.
Videos should have captions for users who are hard-of-hearing. The difference between captions and subtitles is that captions contain both a translation of the video dialogue to text and a description of the background sound, while subtitles contain only the translation of the spoken dialogue to text. Captions provide the same level of information as users would get from hearing the audio.
Except the benefit to make videos accessible to people with hearing impairments, captions give additional benefits:
- Captions help people with limited language skills follow the video by reading the text version of the dialogue
- Captions make it possible to watch videos for users who prefer to have the sound turned off
- Captions improve search engine optimization (SEO)
Configuration in AEM
- Before using the video component, make sure the video you are going to use is uploaded to YouTube, Vimeo or in Assets.
- Add the Image component on you page
- Open the component's configure dialog
Caption
Having a caption is optional. The caption provides a brief description of the video, enhancing accessibility and SEO by offering context for all users.
Type
Select the video type based on the video’s source:
- YouTube/Vimeo
- DAM (Assets) – default
Video
Insert a video from DAM/Assets or paste the URL from Youtube or Vimeo, see information below.
Custom thumbnail image
For video components, the thumbnail image often serves as a visual placeholder or preview before the video is played. See more information below.
Custom alt-text
- Add the custom alt text directly in the Video Component — not in the Asset in DAM. This applies whether you use a custom thumbnail image or one automatically retrieved from YouTube.
- Write the alt text as a short description of what the video is about, not what the thumbnail image shows.
- Screen readers will announce “Play video” before the alt text and “button” after it.
Stripes
You can add Stripes on your video, up to three rows with max. 20 characters on each row.
- Color: Orange or Apricot
- Stripe size: H1-H4
- Alignment: Left or Center
Video – inserting the video
YouTube/Vimeo:
If the video source is YouTube or Vimeo, copy the video URL and paste it into the URL field.
DAM (Assets):
If the video source is DAM, drag the video from Assets in the side panel to the video field in the component. To open the Assets panel, click on "Toggle side panel."
Custom thumbnail image
The video thumbnail is the image displayed before the video starts playing. It acts as a small poster, helping to attract interest and give context at a glance.
Thumbnails work differently depending on the video source.
YouTube videos
For YouTube videos, a thumbnail is automatically retrieved without affecting the page’s loading time. However, editors can still choose to replace it with a custom image if desired.
DAM videos
For DAM videos, a thumbnail must be manually added, and it does impact page loading time—especially if the video file is large. Slow loading times may occur with high file sizes, so use DAM videos with care.
To use a custom thumbnail, drag an image from Assets into the Drop an asset here field. Any image from DAM can be used, but note the following:
- Use JPG files, since PNG files are not supported – they will be replaced with a default oak image.
- The image will be cropped to fit the video window.
- Don't use a thumbnail with text in the image. If you want text to be displayed in the thumbnail, use Stripes instead. If you have a longer text, add a Rich text editor above the video component.
Custom alt-text
The alt text for this thumbnail image is important for accessibility. If the custom alt text field is left empty, AEM will automatically retrieve the alternative text from the associated asset in the Digital Asset Manager (DAM).