Microsoft Azure Storage for WordPress


This WordPress plugin allows you to use Microsoft Azure Storage Service to host your media and uploads for your WordPress powered website. Microsoft Azure Storage is an effective way to infinitely scale storage of your site and leverage Azure’s global infrastructure.

For more details on Microsoft Azure Storage, please visit the Microsoft Azure website.

Known Issues

Storage Account Versions

Storage accounts can be created via CLI, classic Azure portal, or the new Azure portal,
with varying results.

If a Storage account is created with the new Azure portal, authentication will fail,
resulting in the inability to view/add containers or files. Creating a Storage account
with the Azure CLI should allow the plugin to work with new Storage accounts.

Responsive Images in WordPress 4.4

Images uploaded to the Azure Storage service will not automatically receive responsive versions.
Images added through the WordPress Media Loader should get automatically converted to responsive
images when inserted into a post or page.
We are investigating options for full support of responsive images in the plugin.


  1. Upload the plugin files to the /wp-content/plugins/windows-azure-storage directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Use the Settings->Microsoft Azure screen to configure the plugin.

For multisites or to enforce Azure Blob Storage settings, you can define the following constants in wp-config.php:

  • MICROSOFT_AZURE_ACCOUNT_KEY – Account Primary Access Key
  • MICROSOFT_AZURE_CONTAINER – Azure Blob Container
  • MICROSOFT_AZURE_CNAME – Domain: must start with http(s)://
  • MICROSOFT_AZURE_USE_FOR_DEFAULT_UPLOAD – boolean (default false)

See Settings->Microsoft Azure for more information.


December 9, 2019
It claims that files are uploaded, but they do not get saved in Azure Storage.
May 17, 2019
There is support for this plugin ? Seems that with Azure Blob Storage and WP 5.x there are problem with some missing images.
Read all 7 reviews

Contributors & Developers

“Microsoft Azure Storage for WordPress” is open source software. The following people have contributed to this plugin.


“Microsoft Azure Storage for WordPress” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Microsoft Azure Storage for WordPress” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Added support for Media Library upload process change introduced in WordPress 5.3
  • Offload “original_image” file introduced in WordPress 5.3
  • Fix issue with special characters in filenames with url encoding
  • Fix issue with media regeneration via WP CLI


  • Added ability to setup Azure settings using constants in wp-config.php file
  • Added ability to filter cache-control option for blob files and enter arbitrary cache-control value in the settings
  • Bug fix to support special characters in file names


  • Removed build tools from the plugin repository
  • Updated authors list


  • Added error message when SimpleXML library is not found
  • Added ability to enter Cache-Control property
  • Renamed plugin to be Microsoft Azure Storage for WordPress
  • Fixed trailing slash issue which led to double slashes in URLs
  • Fixed minor warnings


  • Fixed uploading issue when year/month based folders are not used
  • Fixed CNAME issue in the srcset attribute when yar/month based folders are not used
  • Added POT file and loaded text domain


  • Bug fix for 0-byte uploads.


  • Fix blob name while media file
  • Show admin notice if can’t access files directly


  • Removed old PHP SDK and use WordPress HTTP API based client library.
  • Added compatibility with API version 2015-12-11.
  • Added compatibility with PHP 5.3+.
  • Improved overall performance.
  • L10N/I18N: Round 2 of preparing strings for translation.
  • Refactored code to match WordPress standards.
  • Better UX by adding more feedback during long operations.
  • Integrated Azure Blob browser into WordPress Media Library.
  • Added option to keep local files after uploading them to Azure Blob.
  • Exposed new developer filters.
  • Deduplicated code functionality.
  • Security: validate, sanitize, and escape (allthethings).


  • Fix browsing and uploading caused by broken nonce checks.
  • Normalize the SDK path for activation checks.


  • Security: fixes a bug that could allow unauthorized deletion of remotely-stored media.
  • Security: validate, sanitize, and escape (allthethings).
  • Security: use https:// URLs by default, and warn if an insecure CNAME is configured.
  • Security: introduce permissions checks for specific actions within the plugin.
  • L10N/I18N: Round 1 of preparing strings for translation.
  • UI: Editor button more closely matches the WordPress Admin UI.
  • Add srcset to images added through the Media Library when Azure is the default media handler. (Props @patricknami).


  • Fixed network activation bug in WordPress multisite.
  • Fixed the issue with duplicate blob names in XML-RPC.


  • Fixed the issue with duplicate blob names.
  • Fixed the bug in uploading video files to blob storage.
  • Fixed the bug with forward slash in front of image thumbnail filenames.
  • Fixed the bug with year and month getting trimmed for file system images.


  • Updated to use Microsoft Azure SDK for PHP from and fixed to work with WordPress 3.4.1


  • Fixed case sensitivity error in file names on Linux


  • Bug fixed in generating blob storage URL when using Microsoft Azure Storage emulator


  • Added support to upload video files to blob storage


  • Included Microsoft Azure SDK for PHP v4.1.0 with the plugin. Now setting mime-type for uploaded file to blob storage.


  • Included Microsoft Azure SDK for PHP v4.0.2 with the plugin.


  • Included Microsoft Azure SDK for PHP v4.0.1 with the plugin, so no need to install the SDK separetely. Also fixed thumbnail handling issue while uploading files when some specific theme is enabled.


  • This release is compatible with Microsoft Azure SDK for PHP v3.0.0. It also fixes issue with deleting media files when thumbnails are associated.


  • This release is compatible with Microsoft Azure SDK for PHP v2.1.0 and WordPress 3.1


  • First release of Microsoft Azure Storage plugin for WordPress