Embed alugha videos in WordPress

Summary

Embed alugha videos in WordPress with the official alugha Video Embed plugin — a lightweight Gutenberg block that accepts a video URL, video ID, or watchlist URL and renders a responsive 16:9 alugha player with automatic language switching. Prefer to avoid plugins? Drop the raw embed code into a Custom HTML block instead.

Prerequisites

Before you begin:

A WordPress site running WordPress 5.8 or newer with the block editor (Gutenberg) active.
Admin access to upload plugins, or editor access with Custom HTML block permission if you prefer the plugin-free route.
A published alugha video (see Publish your multilingual video project).

Option A — Install the alugha WordPress plugin

The plugin adds a native Gutenberg block called alugha Video that you can drop into any post or page. Behind the scenes it renders the same responsive iframe the embed dialog produces — just without copy-pasting.

1. Download the plugin

Download the plugin ZIP:

alugha-gutenberg-embed.zip (latest version, 5.6 KB)

Do not unzip the file — WordPress handles that during installation.

2. Install and activate

In your WordPress admin:

Open Plugins → Add New.
Click Upload Plugin at the top of the page.
Choose the alugha-gutenberg-embed.zip file and click Install Now.
Click Activate Plugin after the install finishes.

The plugin appears in your active plugins list as alugha Video Embed.

3. Insert the alugha Video block

Open any post or page in the block editor. Click the + insert button, search for alugha, and select the alugha Video block (it lives under the Embeds category with a camera icon).

Paste one of the following into the block’s input field:

A full alugha video URL (for example https://alugha.com/videos/abc-123-def) — the plugin extracts the ID automatically.
Just the video ID (the UUID after /videos/).
A watchlist URL — the block renders the full watchlist in a single embed.

Save the post. The front-end shows a responsive 16:9 alugha player with automatic language detection, subtitles, and controls — no further configuration needed.

Option B — Paste the embed code into a Custom HTML block

Prefer to skip the plugin? WordPress’s built-in Custom HTML block accepts the alugha embed code as-is. This is a good option when you only embed one or two videos, or you do not have plugin-install permissions.

1. Copy the embed code from the dubbr

Follow Share your video with a link or QR code to open the SHARE YOUR PROJECT dialog, then switch to the EMBED OPTIONS tab. Configure language, subtitles, size, and any Custom Options (autoplay, loop, start time), then click COPY.

The copied snippet looks like this:

<div style="position: relative; height: 0; padding-bottom: 56.25%;">
  <iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border: 0;"
    allow="fullscreen; picture-in-picture" allowfullscreen
    src="https://alugha.com/embed/web-player?v=YOUR_VIDEO_ID">
  </iframe>
</div>

2. Paste into a Custom HTML block

In the WordPress block editor, click the + insert button and search for Custom HTML. Paste the embed snippet into the block.

Use Preview (top of the block) to see the rendered player. Save the post when you are happy with the result.

Plugin vs. Custom HTML — when to use which

Use the plugin when you embed alugha videos often, want a native block with a friendly input, or support watchlists. One-time setup, zero copy-paste per video.
Use Custom HTML when you need fine-grained embed options (autoplay, loop, start time, language override, custom branding) — those live in the EMBED OPTIONS tab of the share dialog and are baked into the iframe src.

Both approaches render the exact same alugha player on the front-end – the plugin just simplifies the content editor experience.

Good to know

The plugin is free and licensed under GPL-2.0-or-later. No account required to install.
The rendered iframe is responsive 16:9 by default – the player scales to the width of its container on every device.
The player handles automatic language switching based on each viewer’s browser language (see Understand the automatic language switcher).
Both the plugin output and the raw embed code include the allow="fullscreen; picture-in-picture" permission, so viewers can expand the player on any modern browser.
The plugin uses lazy loading (loading="lazy") — the iframe only loads when it scrolls into view, saving bandwidth on posts with several embeds.
Page builders like Elementor, Beaver Builder, or Divi also accept the Custom HTML embed — drop it into any HTML/Code widget.

Troubleshooting

The alugha Video block does not appear in the inserter:

Confirm the plugin is activated (Plugins → Installed Plugins).
Make sure you are using the block editor — the Classic Editor does not load Gutenberg blocks. Use the Custom HTML option instead if Classic is locked in.
Clear your browser cache or hard-reload the editor.

The video shows a blank player or “Video not found”:

Check the video is published and the project STATE is Public or Unlisted (see Set video visibility and privacy).
Test the URL directly in a browser tab — if it works there but not in WordPress, try a different browser or clear the cache.

The player is not full width:

The iframe is responsive but inherits its width from the container. If your post layout constrains it, widen the block (change alignment to Wide or Full) or the theme column.

Embed options (autoplay, custom colour) do not apply:

The plugin block ships with default embed settings. For custom options, use Custom HTML with a code generated from the EMBED OPTIONS tab (see Set autoplay, loop, and start time for embeds and Customize your alugha player appearance).

Was this article helpful?