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.

For more details on configuring a Microsoft Azure Storage account and on using the plugin with the Block Editor or Classic Editor, please visit the user guide.

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.


October 9, 2021 1 reply
It works excellent, it is the only plugin there is, I am glad that it has no problems.
February 27, 2021 2 replies
There are 5 pages of reported issues for this plugin. Most of them without any answer. Uploading a file while enabled “Auto remove local files” shows infinity loading. Too bad. Azure is a great AWS S3 alternative. Without any maintained plugin for Wordpress. Shame.
March 13, 2020 1 reply
Another quality plugin from the folks at 10up. I had used the S3 offloader from Delicious Brains for other projects, but the current client is using Azure. This plugin is about as one-click easy as it gets, and it works well.
March 9, 2020
This is nice plugin with easy setup (if you know what you are doing). If you setup Azure Storage Container with a CNAME, you will get lovely external storage for you uploads, where URLs will show as something else or so which is perfect solution for me.
Read all 13 reviews

Contributors & Developers

“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.


4.4.2 – 2024-05-06

Note that this release bumps the minimum WordPress version from 5.7 to 6.3.

4.4.1 – 2024-01-08

4.4.0 – 2023-10-17

Note that this release bumps the minimum PHP version from 7.4 to 8.0

4.3.5 – 2023-07-10

4.3.4 – 2023-01-12

4.3.3 – 2022-06-30

4.3.2 – 2021-03-03

4.3.1 – 2020-02-12

  • Fixed: Restore visual indicator of upload progress to Azure Blob Storage and account for original_image in count (props @rickalee, @moraleidame).
  • Fixed: Ensure PDF thumbnails are offloaded with JPEG mimetype instead of PDF (props @rickalee)
  • Fixed: Normalize file paths on Windows Server (props @nanasess)

4.3.0 – 2019-11-18

  • Added: Support for Media Library upload process change introduced in WordPress 5.3.
  • Added: Offload original_image file introduced in WordPress 5.3.
  • Fixed: Issue with special characters in filenames with url encoding.
  • Fixed: Issue with media regeneration via WP CLI.

4.2.0 – 2018-05-04

  • Added: Ability to setup Azure settings using constants in wp-config.php.
  • Fixed: Images uploading issue in the multisite environment, now it doesn’t strip sites/{id} from filename.
  • Fixed: srcset issue for images uploaded before 4.2.0 version.
  • Fixed: Issue with special characters in filenames with url encoding.

4.1.1 – 2018-01-31

  • Changed: Updated authors list.
  • Removed: Build tools from the plugin repository.

4.1.0 – 2017-11-22

  • Added: Error message when SimpleXML library is not found.
  • Added: Ability to enter Cache-Control property.
  • Changed: Renamed plugin to be Microsoft Azure Storage for WordPress.
  • Fixed: Trailing slash issue which led to double slashes in URLs.
  • Fixed: Minor warnings.

4.0.3 – 2017-10-19

  • Added: POT file and loaded text domain.
  • 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.

4.0.2 – 2017-03-02

  • Fixed: Bug for 0-byte uploads.

4.0.1 – 2017-01-03

  • Fixed: Blob name while media file.
  • Fixed: Show admin notice if can’t access files directly.

4.0.0 – 2016-11-10

  • Added: Compatibility with API version 2015-12-11.
  • Added: Compatibility with PHP 5.3+.
  • Added: L10N/I18N: Round 2 of preparing strings for translation.
  • Added: Integrated Azure Blob browser into WordPress Media Library.
  • Added: Option to keep local files after uploading them to Azure Blob.
  • Added: Introduced filter azure_blob_operation_timeout which defines REST operation timeout.
  • Added: Introduced filter azure_blob_list_containers_max_results which defines max size of containers listing per one request.
  • Added: Introduced filter azure_blob_list_blobs_max_results which defines max size of blobs listing per one request.
  • Added: Introduced filter azure_blob_put_blob_headers which defines headers used for creating new blob.
  • Added: Introduced filter azure_blob_append_blob_headers which defines headers used for appending created blob.
  • Changed: Removed old PHP SDK and use WordPress HTTP API based client library.
  • Changed: Improved overall performance.
  • Changed: Refactored code to match WordPress standards.
  • Changed: Better UX by adding more feedback during long operations.
  • Changed: Deduplicated code functionality.
  • Security: Validate, sanitize, and escape (allthethings).

3.0.1 – 2016-03-01

  • Fixed: Upload nonce checks.
  • Fixed: Media: AYS checks on browse.

3.0.0 – 2016-02-03

  • Added: L10N/I18N: Round 1 of preparing strings for translation.
  • Added: srcset to images added through the Media Library when Azure is the default media handler. (Props @patricknami).
  • Changed: UI: Editor button more closely matches the WordPress Admin UI.
  • 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.

2.2.0 – 2016-02-02

  • Fixed: Network activation bug in WordPress multisite.
  • Fixed: Issue with duplicate blob names in XML-RPC.

2.1.0 – 2014-07-03

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

2.0.0 – 2014-07-03

1.9.0 – 2012-01-06

  • Fixed: Case sensitivity error in file names on Linux.

1.8.0 – 2012-01-06

  • Fixed: Bug in generating blob storage URL when using Microsoft Azure Storage emulator.

1.7.0 – 2012-01-05

  • Added: Support to upload video files to blob storage.

1.6.0 – 2012-01-05

  • Added: support to upload video files to blob storage.

1.5.0 – 2012-01-04

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

1.4.0 – 2011-08-26

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

1.3.0 – 2011-08-16

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

1.2.0 – 2011-06-03

  • Added: Compatibility with Microsoft Azure SDK for PHP v3.0.0.
  • Fixed: Issue with deleting media files when thumbnails are associated.

1.1.0 – 2011-03-03

  • Added: Compatibility with Microsoft Azure SDK for PHP v2.1.0 and WordPress 3.1.

1.0.0 – 2010-05-20

  • First release of Microsoft Azure Storage plugin for WordPress.