=== Advanced Responsive Video Embedder for Rumble, Odysee, YouTube, Vimeo, Kick ... ===
Contributors: nico23
Donate link: https://nextgenthemes.com/donate/
Tags: embed, video, lazyload, lightbox, rumble
Requires at least: 6.6
Tested up to: 6.9.1
Requires PHP: 7.4
Stable tag: 10.8.4
License: GPL-3.0
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Level up your basic video embeds! Advanced features, privacy. Use URLs, Shortcodes or Blocks to customize videos to your needs.

## Description ##

The best WordPress plugin for videos? Supports close to everything you can imagine, still keeping it easy & simple.

It is very likely the one and only plugin you will ever need to handle video embeds on your WordPress site(s). It goes far beyond just making your videos responsive!

[youtube https://www.youtube.com/watch?v=m6mkA6Zr1vY ]

### Features ###

#### Classic Editor ####

*  Adds "Embed Video" button to help you create very powerful `[arve]` shortcodes.
*  Takes over WordPress embeds with URLs on their own line and `[embed]` shortcodes.
*  Can take over WP's default video file embeds.

#### Block Editor (Gutenberg) ####

*  Works with Embed, YouTube, Vimeo, Shortcode ... blocks.
*  Provides it's own powerful ARVE Block with all the features the `[arve]` shortcode offers, with a nice UI and detailed settings descriptions.

#### Elementor ####

* Provides a widget for the entire feature set of ARVE inside Elementor

#### All ####

*   Makes your video embeds [more secure and enhances visitors privacy](https://nextgenthemes.com/privacy-enhanced-and-safer-iframes-in-arve-10-0/).
*   Magically makes videos responsive you already embedded with WordPress default features.
*   SEO friendly, lets you specify title, description, upload date to provide search engines with the schema.org data they like to have for better indexing. Pro can autofill this for you.
*   No 'lock in' if you do not use the ARVE Gutenberg Block or `[arve]` shortcodes.
*   Supports [almost every video host](https://nextgenthemes.com/plugins/arve-pro/#provider-support) that supports iframe embed codes.
*   Embeds via pasting the URL in its own line just like WordPress!
*   Optionally use very powerful Shortcodes instead.
*   Clean shortcode syntax `[arve url="https://youtu.be/yUCFRL43Zm4" parameters="start=30" ... /]`, no unnecessary shortcode wrapping.
*   One shortcode or Block for all video providers.
*   Responsive embeds with CSS, much better than with JavaScript.
*   Tries to be as unobtrusive as possible, sets 'hide brand' variables if supported, disables related videos from other channels at the end … to help keep people on your site rather then going to YouTube or keep watching videos.
*   Limited Autoplay (Mobile browsers usually prevent autoplay or allow it only muted. ARVE will automatically mute it but browser settings can still prevent it, even on Desktop)
*   Custom URL parameters to use all options providers offer.
*   Optional maximal width.
*   Video alignment.
*   Detailed description of options in-place.
*   Automatic detected and custom aspect ratio.

#### Supported Providers ####

[All providers with iframe embed codes](https://nextgenthemes.com/plugins/arve/documentation/#general-iframe-embedding)
Alugha, Archive.org, Banned.video, Bitchute, Brightcove, Brighteon, Dailymotion, Dailymotion Playlist, DTube, Facebook, Google Drive, mp4 or webm video files, ARVE general iframe embed, IGN, IMDB, Kickstarter, kla.tv, Mail.ru, myspace, v.qq.com, Rumble.com, ok.ru, RuTube.ru, TED Talks, TikTok, Twitch, Viddler, Vimeo, VK, Wistia, XTube, xHamster, Yahoo, Youku, YouTube, YouTube Playlist, Kick
### Reviews ###

#### &#9733; &#9733; &#9733; &#9733; &#9733; Great plugin, great support ####
I’ve been using this plugin (free version and pro add-on) for a few years now. It works very well for my purposes (mainly lazyload and lightbox functionality). Recently I had a support issue with the new version which required some intervention – it was a conflict with my theme. Nico, the developer, went above and beyond to get a fix promptly sorted out for me. Thank you Nico.

#### &#9733; &#9733; &#9733; &#9733; &#9733; The best there is – I have tried many…  ####
Have downloaded and paid for at least 4 other video players that use lightbox. Each one has major flaws. This products works perfectly. If you use the OnSite Editor, then just copy the short code and it works great.

[arve url="https://www.youtube.com/watch?v=Z7g8-GxLTSc" /]

For speed, the product uses the thumbnails from the server. So many of the other products do NOT do this and it slows the page rendering. This product should appear first on the WordPress search. Spent 3 days of my life wasted on other products, only to delete each one. [review by jodani][16]

#### &#9733; &#9733; &#9733; &#9733; &#9733; Finally something that works ####
So I have a responsive theme but on pages with you tube videos it wasn't making the you tube videos fit in the mobile screen. I have spent the last hour trying many plugins and researching on google and finally I installed this. And I didn't have to update any settings or anything just refreshed a post with videos and all the sudden it is beautiful and responsive on my mobile phone!!!!!! THANK YOU!!!! [review by happyecho][16]

#### &#9733; &#9733; &#9733; &#9733; &#9733; Only Plug-in that worked ####
I used a lot of high ranking plug-ins but they still broke my design. Downloaded this and worked right away. Thanks! [review by crconnell89][16]

[16]: https://wordpress.org/support/plugin/advanced-responsive-video-embedder/reviews/?filter=5

### [ARVE Pro][20] ###

**<big>10% off</big>** first year with discount code `wporg`.

This plugin is financed by purchases of [ARVE Pro][20]. The development and support of this plugins has become a job for me, so I hope you understand that I can not make all features gratis and that you [purchase it][20] to get extra features and support the development.

*   **Disable links in embeds (killer feature!)**<br>
    For example: Clicking on a title in a YouTube embed will not open a new tab. **Prevent video hosts to lead your visitors away from your site!**
*   **Lazyload**<br>
    Make your site load **faster** by loading only an image instead of the entire video player on pageload.
*   **Lightbox**<br>
    Shows the Video in a Lightbox after clicking a Lazyload preview image
*   **Link ⇾ Lightbox**<br>
    Use simple links as triggers for opening Video Lightboxes
*   Auto pause videos when another video is played
*   Automatic or custom thumbnail images
*   Automatic or custom titles on top of your thumbnails
*   'Expand on click' feature
*   2 hover & 3 play icon styles
*   Responsive thumbnails (srcset)
*   **Feel good about yourself**<br>
    for supporting my 8+ years work on this plugin. Tons of hours, weekends … always worked on improving it
*   Show the latest video of a YouTube channel by using the channel URL (updated/cached hourly)
*   **[Get ARVE Pro][20]**

[20]: https://nextgenthemes.com/plugins/arve-pro/

### [ARVE Sticky Videos][23] ###

Keep videos on the screen when scrolling.

*  Choose if videos should be pinned to the top of the screen. Like the YouTube app for example.
*  For bigger screen choose a corner where a video should be pinned to. Like last.fm [for example][23].

  [23]: https://nextgenthemes.com/plugins/arve-sticky-videos/

### [Random Video Addon](https://nextgenthemes.com/plugins/arve-random-video/) ###

Display random video from:

*  YouTube Playlist
*  Vimeo Showcase
*  Comma separated list of video URLs

### [ARVE AMP][29] ###

When you use the AMP or 'AMP for WP' plugin you need this.

* It will display videos embedded with ARVE on AMP pages correctly
* No options, just works
* It creates `<amp-youtube>`, `<amp-vimeo>`, `<amp-dailymotion>` elements
* For all other video hosts `<amp-video-iframe>` element is used
* Video files are also supported with `<amp-video>`

  [29]: https://nextgenthemes.com/plugins/arve-amp/

### Thanks ###

*   Of course all the customers who bought a addon.
*   Howard Iken of [myfloridalaw.com](https://www.myfloridalaw.com) top donor, super nice to me even if I was rude and not deserved it!
*   [Ilya Grishkov](https://www.ilyagrishkov.com) for bringing up the idea and the first code to cache thumbnail urls.
*   Everybody giving constructive feedback, testing beta versions.
*   Everybody who donated back in the days when this was donation based.

### Thanks to the developers of the software used in ARVE ###

*   [Bigger Picture](https://github.com/henrygd/bigger-picture), used in [Pro Addon](https://nextgenthemes.com/plugins/arve-pro/)

## Frequently Asked Questions ##

### I have a problem ... ###

Please report it on [nextgenthemes.com/support/](https://nextgenthemes.com/support/) **and please do not on the wordpess.org forums, thanks.**

### I’m experiencing these errors on Google Search Console ###

Best option to resolve these errors is to get [ARVE Pro](https://nextgenthemes.com/plugins/arve-pro/) as it fills these in for you hassle-free, only activate the add-on - done. For more options, please see the [detailed answer](https://nextgenthemes.com/plugins/arve/faq/).

### How to get the pro version working? ###

1. Go though the purchase process on [nextgenthemes.com](https://nextgenthemes.com/plugins/arve-pro/)
1. Follow the 3 easy steps you get with the purchase receipt. It is basically downloading a arve-pro.zip and installing it through your WordPress Admin panel.
1. After that you may want to switch your default mode to Lazyload or Lightbox on the ARVE settings page.

### Why are my videos not filling their container? ###

You may need to adjust your 'Maximal Width' setting to your liking.

You are most likely use `align`, this plugin has a option for limiting video width with alignment. If you want your videos to fill their containers then you should not use the `align` shortcode attribute.

### Can you add a video provider? ###

Feel free to ask.

### How do I embed videos from a unlisted providers / iframes? ###

This plugin not changes anything to usual HTML `<iframe>` embed codes you have to use the shortcodes or the Gutenberg Block. They will become `[arve url="https://..."]`. The url represents what is the `src` in HTML embeds. It works as simple as this, if the `[arve]` shortcode does not detect a known URL structure then it will treat the URL as a `src` for the iframe.

## Installation ##

Please read the [official documentation](https://wordpress.org/support/article/managing-plugins/#installing-plugins) for that.

## Screenshots ##

1. Block Editor Example
2. Shortcode creation dialog in Classic Editor
3. Main Options
4. Pro Options
5. Video Files Options
6. URL Parameter Options
## Changelog ##

* [ARVE Pro changelog](https://nextgenthemes.com/plugins/arve-pro/#changelog)
* [ARVE Random Videos changelog](https://nextgenthemes.com/plugins/arve-random-video/#changelog)

### 2026-02-19 10.8.4 ###

* Fix: Removes `.video-container` from Hueman Child Theme to fix aspect ratios.

### 2026-02-17 10.8.3 ###

* Fix: Errors on when saving settings related to old plugin options.
* Improved: Provider data is not loaded more efficiently only once.

### 2026-01-18 10.8.2 ###

* New: Added `#t=0.1` to HTML5 video sources to fix Safari not showing still frames.

### 2025-11-16 10.8.1 ###

* Fix: Give all React elements keys to prevent console errors.
* Fix: Show all settings in Block when settings are set to default.

### 2025-11-14 10.8.0 ###

* Fix: YouTube playlists 153 error on Frontend.
* Fix: YouTube error 153 inside the Block editor.
* Improved: Block improved, new sorting by categories.
* Improved: Lots of code improvements.
* New: Privacy addon feature moved to free plugin: Removes `si` parameter from YouTube URLs when doing oEmbed requests.

### 2025-10-22 10.7.1 ###

* Fix: SEO `uploadDate` not being in ATOM format for Vimeo.
* Improved: `uploadDate` timezone handling. All formats that php can handle are converted to ATOM format. If timezone is not part of the string, the WordPress timezone setting is used when the time was manually entered. Otherwise UTC is used.
* Improved: Code improvements. Thanks to phpstan and AI.
* Improved: Viddler detection.
* Improved: updated allow_directives.
* Improved: removed old providers that went down.

### 2025-07-30 10.6.13 ###

* Fix: _load_textdomain_just_in_time was called incorrectly.
* Fix: Minor visible error on debug tab with WP_DEBUG enabled.

### 2025-03-22 10.6.12 ###

* Fix: HTML mistake on the setting page.
* Improved: Hide some old errors.

### 2025-03-21 10.6.10 ###

* Fix: Removing ARVE data from oembed cache on uninstall.
* Improved: Error messages and escaping for remote calls.
* Improved: Lots of things around caching and how the errors are (not) displayed.

### 2025-03-17 10.6.8 ###

* Improved: ARVE now handles the execution of addons, not executing outdated addon.
* Improved: Added outdated messages for all addons.

### 2025-03-16 10.6.7 ###

* Fix: Compatibility with Advanced Custom Fields WYSIWYG editors. The ARVE shortcode creation button now finally works there.

### 2025-03-15 10.6.6 ###

* Improved: Tested with WP 6.8-beta2
* Improved: Updated jetpack autoloader.
* Improved: Cache deletion.
* Improved: Handling of error messaged of YouTube Data API errors.
* Abandoned asset wrappers.
* Renamed shared code package, now [nextgenthemes/wp-settings](https://packagist.org/packages/nextgenthemes/wp-settings) on Packagist.

### 2025-03-09 10.6.5 ###

* Fix: Cache management related old YouTube video having broken thumbnails.

### 2025-03-09 10.6.4 ###

* Fix: Link to settings page in API key notice.
* Improved: Link to tutorial video showing you how to get an YouTube Data API key.

### 2025-03-09 10.6.1 ###

* Improved: Error handling. Show YouTube API errors only on the Admin screens.
* Improved: Cache deletion.
* New: Option to add your own YouTube Data API key to prevent limits of the one included in Pro.

### 2025-03-08 10.6.0 ###

* New: Lazyload Style option (Pro Feature).
* Fix: Settings page conflicts with admin notices (from other plugins).
* Fix: `_load_textdomain_just_in_time` being triggered too early.
* Improved: Styles for the settings page and Classic Editor shortcode creator dialog.
* Improved: Simplified the way ARVE generates HTML using `WP_HTML_Tag_Processor`.
* Improved: `dnt=1` parameter is now part of the visible default parameters for Vimeo and Wistia. You may need to remove it or set it to `0` to get your views tracked by them.

### 2025-01-15 10.5.4 ###

* Improved: Removed incompatibility notices for AIO SEO Pack (resolved).

### 2025-01-11 10.5.3 ###

* Fix: Fixed, improved and restored Shortcode UI functionality. 

### 2025-01-08 10.5.2 ###

* Fix: Block errors.

### 2025-01-02 10.5.1 ###

* Fix: Array merge with NULL error.

### 2025-01-02 10.5.0 ###

* New: Debug option to control src mismatch errors.
* Improved: Removed the debug into in favor or adding data to the Site Health Info screen.
* Improved: Introduced a `SettingsData` and `SettingValidator` classes to make the code more robust self testing.

### 2024-12-05 10.4.0 ###

* New: Added `credentialless="false"` parameter that can be used to remove the same named attribute from the iframe.
* Fix: Added `data-lenis-prevent` to the ARVE wrapper div to prevent issues with Lenis Smooth Scroll script. 
* Fix: Viddler not working by allowing `sync-xhr`.
* Improved: Changes enabling latest ARVE Pro versions to use `sizes="auto"` for more efficient image loading.
* Improved: Featured image as fallback default change to `true` (Pro).
* Improved: ARVE now includes a black image with stripes used as default fallback thumbnail.
* Improved: Removed some legacy code, outdated addons are prevented from executing.

### 2024-11-08 10.3.4 ###

* Fix: xHamster not working. Its direclty supported with normal URLs now. Note ARVE needs to allow referrer to be send, with this privacy enhancement disabled xHamster will see the domain you are embedding from.
* Fix: multisite (needs to be confirmed).

### 2024-10-23 10.3.3 ###

* Show messages about incompatibility issue with All in One SEO Pack.
* Fix: Duplicated controls in ARVE Block sidebar.
* Fix: Help tests were not showing in Settings page.

### 2024-08-22 10.3.2 ###

* New: URL detection for VK.com videos.

### 2024-08-02 10.3.1 ###

* New: Add current theme and version to Debug Info.
* Fix: PHP error when `$GLOBALS['content_width']` is not an integer. Props Gianluca.

### 2024-07-17 10.3.0 ###
* WP 6.6 marked as required.
* New: Brings back support for Shortcode UI that was removed previously. Note that in SCUI it uses yes/no and ARVE dialog uses true/false. There may come some improvement on that later.
* Fix: Remove script module and WP interactivity registering as this is done by WP in 6.6 now and caused double register and ordering issues.
* Fix: Make sure the ARVE shortcode modal is closed when selecting a thumbnail and reopened afterwards.

### 2024-07-06 10.2.3 ###
* Fix: Help toggle in new ARVE Shortcode dialog.
* Improved: Show message that the ARVE Button in Classic Editor needs WP 6.6 (sorry, to be released 2024-07-16).

### 2024-06-17 10.2.2 ###
* Fix: Rare src mismatch errors with YouTube.
* Improved: Set block api version to 3.
* Improved: Show message that the ARVE Block needs Gutenberg active or WP 6.6.

### 2024-06-17 10.2.1 ###
* Improved: Set WP required version to 6.5 in main plugin file, previously only set in readme.

### 2024-06-15 10.2.0 ###
* New: Invidious URL Parameter setting for new extra privacy addon.
* Fix: Encoding and JSON errors related how things were stored in oembed cache.
* Fix: Issue activating licenses.
* Improved: Yet another Setting page overhaul, dropping Alpine.js for WP Interactivity API.
* Improved: Bring back reset buttons for settings sections.
* Improved: A couple of typos.
* Removed Shortcode UI support. (That plugin did now have a release in 5 years, the ARVE dialog is better anyway IMO)
* Compatibility with latest Pro addon.

### 2024-05-27 10.1.1 ###
* Improved: Changes how the referrer setting works. `no-referrer` by default `strict-origin-when-cross-origin` for selected providers.
* Fix: Some YouTube videos (music?) do not without without allowing reverer to be send so YouTube was added to the list to allow it by default.

### 2024-05-24 10.1.0 ###
* Improved: ARVE own video IDs are no longer random, this is better for SEO and other things.
* New: Support for [ok.ru](http://ok.ru).
* New: Rutube video url detection. (only embed code worked before).

### 2024-05-23 10.0.10 ###
* Fix: Videos with quotes in the title/description caused json_decode syntax error.

### 2024-05-22 10.0.9 ###
* Fix: Some Vimeo videos not working without cache working.
* Fix: src mismatch error testing.
* Improved: Error display.

### 2024-05-21 10.0.8.1 ###
* Fix: Do not delete cache every time.

### 2024-05-21 10.0.8 ###
* Fix: Some broken Vimeo videos. And possibly other bugs.

### 2024-05-21 10.0.7 ###
* Fix: Lazyload and Lightbox (Pro) were not displayed when used with video files.

### 2024-05-17 10.0.6 ###

#### Improved
* Performance of oembed deletion.
* Move the "Delete oEmbed cache" button to the top of the Debug tab in the Settings. Press it if you have trouble with thumbnails.

### 2024-05-15 10.0.5 ###
* Fix?: Initialize deletion of oembed caches later.
* New/Fix: Setting to allow domain restricted videos.
* Fix: Show Blog entries in correct order on settings page.

### 2024-05-13 10.0.4 ###
* Fix: Fatal error prevention for people using outdated versions of ARVE Pro while upgrading the main plugin to version 10. Update to Pro 6.x.x is mandatory.

### 2024-05-12 10.0.3 ###
* Fix: Vimeo domain restriction

### 2024-05-12 10.0.2 ###
* Fix: Activation error related to script dependencies. (Elementor)

### 2024-05-11 10.0.1 ###

#### New ####
* Elementor Widget.
* Support for Kick.
* Optional ARVE button on the admin bar for quick access to the ARVE Settings page.
* Support for new [DSGVO and Extra Privacy](https://nextgenthemes.com/plugins/arve-privacy/) addon.

#### Fixed ####
* Pasting iframe embed code in the URL/Embed Code field in the Block Editor.

#### Improved ####
* Lots code changes to modernize and make the code more robust.
* Better way to negate WPs own aspect ratio for embed blocks.
* [Further privacy enhancements](https://nextgenthemes.com/privacy-enhanced-and-safer-iframes-in-arve-10-0/).
* New look and UX improvement to the shortcode creation dialog in Classic Editor.
* Loop and Mute previously were only used for (self hosted) video files. These shortcode attributes now add `loop=1&mute1` to the iframe `src` as well. Note not every provider supports them. To loop YouTube videos the video ID was also need as the `playlist=` parameter. ARVE is doing this automatically now.
* Sandbox setting has been replaced with 'Enable Encrypted Media'.

### 2024-02-29 9.10.14 ###
* Fix: Wrongly displayed message about outdated PHP version.

### 2024-02-29 9.10.13.1 ###
* Cut development files from the distribution.

### 2024-02-29 9.10.13 ###
* Improved: Make Admin notice dismiss without jQuery. May fix an extremely rare issue of dismiss failing.   
* Tested with latest WP 6.5-nightly
* Plugin is no longer being tested with PHP versions below 7.2+, in theory the 9.x versions should work with PHP 5.6+.

### 2023-09-16 9.10.12 ###
* Tested with latest WP 6.5-nightly
* Updated warning that next major version will required php 7.4+.

### 2023-05-17 9.10.9 ###
* Fix: Styles not loading correctly in latest Gutenberg versions.

### 2023-04-12 9.10.3 ###
* Fix: Yoast SEO compatibility and other possible issues.

### 2023-04-11 9.10.2 ###
* Fix: Fatal error with WordPress 5.8.6

### 2023-04-11 9.10.1 ###
* New: Warning massage that ARVE will require PHP 7.2 soon.
* New: Support for extra classes (Advanced section) on the ARVE block.
* New: You can align left/right the ARVE block now.
* Fix: Styles were not applied inside new Gutenberg versions.
* Improved: Videos are no longer playable in the Block editor, instead the block is selected when clicking on them.
* Improved: Some minor code changes.

### 2023-02-05 9.9.7 ###
* Fix: WP Courseware Course Builder meta box was always collapsed. (Could not get the ARVE button to work for the Course Description)

### 2023-01-25 9.9.6 ###
* Fix: Rumble videos not work correctly on all cases correct oembed data.

### 2023-01-11 9.9.4 ###
* Fix: Invisible Shortcode creation dialog content.
* Fix: Hide the dialog when the WP image upload dialog is opened.

### 2023-01-10 9.9.3 ###
* Fix: Issue when browser does not support `<dialog>`.

### 2022-01-08 9.9.2 ###

* Fix: Incompatibility with Accelerated Mobile Pages by removing the jquery-ui dependency and using a native `<dialog>` for the shortcode creator modal. This may also fix layering (z-index) issues with other plugins.

### 2022-10-28 9.8.0 ###

* New: TikTok support.
* Improved: Removed deprecated message because it broke the WP login when debug output was enabled.

### 2022-10-14 9.7.17 ###

* Fix: Give errors and prevent php 8.0 and 8.1 from having errors when the aspect ratio contains non integer numbers like `0.9:1` only integers are allowed like `9:10`.
* Improved: Update EDD updater class.

### 2022-09-01 9.7.16 ###

* Fix: Divi endless reload issue is hopefully finally fixed. ARVE Pro users please note this is a workaround that causes previews inside the Divi builder not have the correct data. Most noticeable thumbnails and titles. If you provide a fallback thumbnail in ARVE Pro settings it will show that while you using Divi. The plugin works correctly on the frontend. However the "Video (ARVE)" button currently does not work in Divi.

### 2022-08-30 9.7.15 ###

* Fix: Shortcode Creator dialog with Advanced Custom Fields plugin active.

### 2022-08-22 9.7.14 ###

* Improved: Simplified and reduced debug info.
* Improved: Adjustments for updated ARVE Pro version.

### 2022-08-11 9.7.11 ###

* Fix: Block not registering.

### 2022-08-09 9.7.10 ###

##### Improvements for Gutenberg Block ##### #####
* Introduces clickable area above the Block in the Editor.
* Fixed Thumbnail image overflowing.
* Removed maximal width setting when not aligned. This concept does not fit Gutenberg. Width should be controlled by setting the block to wide or full alignment.
* Introduces a recommended `block.json`.
* Some other minor improvements.

### 2022-08-04 9.7.8 ###

* New: Add new 'Darken' hover effect option for Pro Addon.
* Removed Ustream from providers (not functional bought up by IBM)

### 2022-04-16 9.7.7 ###

* Improved browser support to display aspect ratio correctly on older browsers.

### 2022-02-01 9.7.4 ###

* Fix: '[Vue warn]: Cannot find element: #arve-sc-vue' JavaScript error on admin page.

### 2022-01-29 9.7.3 ###

* Fix: Some internal errors generated for YouTube embeds.

[Older Changes](https://github.com/nextgenthemes/advanced-responsive-video-embedder/blob/master/changelog-2021.md)
