Release note for #12384

CHANGELOG.txt

@@ -26,6 +26,7 @@ Changelog
  * Implement new designs for the footer actions dropdown with more contrast and larger text (Sage Abdullah)
  * All create/edit admin forms now use a sticky submit button, for consistency and to speed up edits (Sage Abdullah)
  * Secondary form actions such as "Delete" are now in the header actions menu (Sage Abdullah)
+ * Add support for uploading HEIC / HEIF images (Matt Westcott)
  * Fix: Prevent page type business rules from blocking reordering of pages (Andy Babic, Sage Abdullah)
  * Fix: Improve layout of object permissions table (Sage Abdullah)
  * Fix: Fix typo in aria-label attribute of page explorer navigation link (Sébastien Corbin)

docs/releases/6.3.md

@@ -45,6 +45,12 @@ This release follows through with "universal listings" user experience and desig
 
 These features were developed by Sage Abdullah.
 
+### HEIC / HEIF image upload support
+
+The `WAGTAILIMAGES_EXTENSIONS` setting now accepts the `heic` extension, which allows users to upload and use HEIC / HEIF images in Wagtail. These images are automatically converted to JPEG format when rendered. For more details, see [](heic_heif_images).
+
+This feature was developed by Matt Westcott.
+
 ### Other features
 
  * Formalize support for MariaDB (Sage Abdullah, Daniel Black)

docs/topics/images.md

@@ -571,10 +571,12 @@ The steps required to set headers for specific responses will vary, depending on
 
 ## HEIC / HEIF images
 
-`.heic` images are not widely supported on the web, but may be encountered when exporting images from Apple devices. Wagtail does not allow upload of these by default, but this can be enabled by adding "heic" to `WAGTAILIMAGES_EXTENSIONS`:
+HEIC / HEIF images are not widely supported on the web, but may be encountered when exporting images from Apple devices. Wagtail does not allow upload of these by default, but this can be enabled by adding `"heic"` to `WAGTAILIMAGES_EXTENSIONS`:
 
 ```python
 WAGTAILIMAGES_EXTENSIONS = ["gif", "jpg", "jpeg", "png", "webp", "heic"]
 ```
 
+Note that to upload HEIC / HEIF images, the file extension must be `.heic` and not `.heif` or other extensions.
+
 These images will be automatically converted to JPEG format when rendered (see [](customising_output_formats)).