Video Offload for VideoPress offloads locally-stored videos to VideoPress via Jetpack, then replaces local video references in post content with the native VideoPress block.<\/p>\n\n
<video><\/code> tags, [video]<\/code> shortcodes, and bare URLs with VideoPress embeds<\/li>\n- Local file cleanup<\/strong> \u2014 delete local files after confirming they are on VideoPress to free up disk space<\/li>\n
- WP-CLI support<\/strong> \u2014 offload and manage videos from the command line with
wp vov<\/code><\/li>\n- Progress tracking<\/strong> \u2014 real-time upload progress with chunked transfer support<\/li>\n<\/ul>\n\n
Requirements<\/h3>\n\n\n- WordPress 6.0+<\/li>\n
- Jetpack<\/a> connected to WordPress.com<\/li>\n
- A plan that includes VideoPress: WordPress.com Premium, Business, or Commerce \u2014 or Jetpack VideoPress or Jetpack Complete<\/li>\n
- VideoPress feature active under Jetpack \u2192 Performance<\/li>\n<\/ul>\n\n
Usage<\/h3>\n\nOffloading videos<\/h4>\n\n\n- Single video<\/strong>: Click Offload to VideoPress<\/strong> next to any video in the Media Library or in the VideoPress Offload admin page<\/li>\n
- Bulk<\/strong>: Use the Offload All to VideoPress<\/strong> button on the admin page to process all pending videos sequentially with a progress counter<\/li>\n<\/ul>\n\n
After offloading<\/h4>\n\n
Each offloaded video gets three actions:<\/p>\n\n
\n- View on VideoPress<\/strong> \u2014 opens the video on VideoPress<\/li>\n
- Replace in Content<\/strong> \u2014 finds every post\/page that embeds the local video and replaces it with a
wp:videopress\/video<\/code> block<\/li>\n- Delete Local File<\/strong> \u2014 permanently deletes the local file from the server (confirm VideoPress has the video first)<\/li>\n<\/ul>\n\n
WP-CLI<\/h4>\n\nwp vov status # Summary of offload status\nwp vov offload # Offload all pending videos\nwp vov offload --id=42 # Offload a single video\nwp vov delete-local # Delete local files for offloaded videos<h3>How it works<\/h3>\n<\/code><\/pre>\n\nThe plugin calls Jetpack's internal \/videopress\/v1\/upload\/{id}<\/code> REST endpoint, which handles chunked uploads and authentication with WordPress.com. Upload state is tracked in post meta so a page refresh mid-upload picks up where it left off and auto-polls until complete.<\/p>\n\nNotes<\/h3>\n\n\n- Offloading requires the site to be publicly accessible (VideoPress fetches the file from the server)<\/li>\n
- Large files upload in chunks; the spinner stays visible for the full duration<\/li>\n
- Clicking an individual Offload button disables the others until the upload completes or errors, preventing simultaneous uploads within the same page session<\/li>\n<\/ul>\n\n
External Services<\/h3>\n\n
This plugin relies on the VideoPress<\/strong> video hosting service, provided by Automattic<\/strong>, to upload, store, and deliver video files. A Jetpack connection and a WordPress.com plan that includes VideoPress are required.<\/p>\n\nWhat the service does:<\/strong> VideoPress hosts and streams video files via a global CDN, replacing locally stored videos with optimized embeds.<\/p>\n\nWhat data is sent and when:<\/strong><\/p>\n\n\n- Video file uploads<\/strong> \u2014 When you click \"Offload to VideoPress\" or run
wp vov offload<\/code>, the plugin uploads the video file to VideoPress through Jetpack's REST API (\/videopress\/v1\/upload\/<\/code>). Video metadata (file name, dimensions, duration) is included with the upload.<\/li>\n- Video existence checks<\/strong> \u2014 When you visit the VideoPress Offload admin page or the Media Library, the plugin verifies that previously offloaded videos still exist on VideoPress by querying the WordPress.com public API (
public-api.wordpress.com\/rest\/v1.1\/videos\/<\/code>). This runs at most once per day per video.<\/li>\n- Embed URLs<\/strong> \u2014 When replacing local video references in post content, the plugin generates embed markup pointing to
videopress.com\/embed\/<\/code> and loads the VideoPress player script from v0.wordpress.com<\/code>.<\/li>\n<\/ul>\n\nService links:<\/strong><\/p>\n\n\n- WordPress.com Terms of Service<\/a><\/li>\n
- Automattic Privacy Policy<\/a><\/li>\n
- VideoPress<\/a><\/li>\n<\/ul>\n\n\n
\n- Upload the
video-offload-for-videopress<\/code> folder to the \/wp-content\/plugins\/<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n- Activate the plugin through the 'Plugins' screen in WordPress.<\/li>\n
- Go to Media \u2192 VideoPress Offload<\/strong> to begin offloading videos.<\/li>\n<\/ol>\n\n\n
\nWhat WordPress.com plans include VideoPress?<\/h3><\/dt>\nVideoPress is included with Premium, Business, and Commerce plans on WordPress.com. For self-hosted sites, Jetpack VideoPress and Jetpack Complete both include VideoPress.<\/p><\/dd>\n
Do I need Jetpack installed?<\/h3><\/dt>\nYes. The plugin uses Jetpack's connection to WordPress.com to upload videos to VideoPress. Jetpack must be installed, activated, and connected.<\/p><\/dd>\n
Will this work on a local\/staging site?<\/h3><\/dt>\nThe offload process requires your site to be publicly accessible because VideoPress fetches the video file from your server. Local or firewalled sites will fail to upload.<\/p><\/dd>\n
What happens to my posts after offloading?<\/h3><\/dt>\nNothing changes automatically. After a video is offloaded, use the Replace in Content<\/strong> action to update all posts and pages that reference the local video. The local wp:video<\/code> block is replaced with a wp:videopress\/video<\/code> block.<\/p><\/dd>\nCan I undo an offload?<\/h3><\/dt>\nThe video remains on VideoPress after offloading. You can delete the local file at any time. To revert content changes, use WordPress revision history on the affected posts.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.5.83<\/h4>\n\n\n- Rename internal prefix from
vov<\/code> to vovp<\/code> (4-character minimum per WordPress.org guidelines)<\/li>\n- Update text domain to
video-offload-for-videopress<\/code> to match plugin slug<\/li>\n- Add External Services section documenting VideoPress\/WordPress.com API usage<\/li>\n
- Improve phpcs:ignore annotation for VideoPress block cacheHtml script tag<\/li>\n<\/ul>\n\n
1.5.82<\/h4>\n\n\n- Code quality improvements for WordPress.org plugin directory submission<\/li>\n
- Update VideoPress availability messaging (Business and Commerce plans only)<\/li>\n
- Add upgrade links for WordPress.com and self-hosted sites<\/li>\n<\/ul>","raw_excerpt":"Offloads locally-stored videos to VideoPress via Jetpack, replacing local references with VideoPress blocks.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ceb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/350680","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ceb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ceb.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ceb.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=350680"}],"author":[{"embeddable":true,"href":"https:\/\/ceb.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/druesome"}],"wp:attachment":[{"href":"https:\/\/ceb.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=350680"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ceb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=350680"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ceb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=350680"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ceb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=350680"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ceb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=350680"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ceb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=350680"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}