From 7bdf5edc0a330788af2045c4b7f6ead52dc9b899 Mon Sep 17 00:00:00 2001 From: Andy Butland Date: Tue, 4 Nov 2025 08:18:27 +0100 Subject: [PATCH 1/3] Added docs for media recycle bin file protection. --- .../reference/configuration/contentsettings.md | 15 ++++++++++++++- .../working-with-images-and-files.md | 6 ++++++ 2 files changed, 20 insertions(+), 1 deletion(-) diff --git a/17/umbraco-cms/reference/configuration/contentsettings.md b/17/umbraco-cms/reference/configuration/contentsettings.md index f05496d1847..139b91957e5 100644 --- a/17/umbraco-cms/reference/configuration/contentsettings.md +++ b/17/umbraco-cms/reference/configuration/contentsettings.md @@ -49,7 +49,8 @@ The following snippet will give an overview of the keys and values in the conten "ResolveUrlsFromTextString": false, "ShowDeprecatedPropertyEditors": false, "ShowDomainWarnings": true, - "ShowUnroutableContentWarnings": true + "ShowUnroutableContentWarnings": true, + "EnableMediaRecycleBinProtection": false } } } @@ -182,6 +183,18 @@ If your routing setup leads to more than one document having the same URL, on pu To suppress these warnings, set this option to `false`. +### Enable media recycle bin protection + +By default, when media is moved to the recycle bin the files are still accessible on their previous, public URL. They will only be unavailable once the recycle bin is emptied or the media item is fully deleted. + +If this is a concern, setting `EnableMediaRecycleBinProtection` to `true` will avoid this. On moving a media item to the recycle bin the file extension will be changed. The change will be reverted if the media item is restored back to it's original location. + +Separately a middleware component will be enabled that will prevent access to these renamed files if the user is not logged into the backoffice. + +When enabling this option, ensure that the media recycle bin is initially empty. + +We will consider making this option enabled by default from Umbraco 18. + ## Content version cleanup policy The global settings for the scheduled job which cleans historic content versions. These settings can be overridden per Document Type. diff --git a/17/umbraco-cms/tutorials/editors-manual/media-management/working-with-images-and-files.md b/17/umbraco-cms/tutorials/editors-manual/media-management/working-with-images-and-files.md index 668dfb836fb..cc0b746ee35 100644 --- a/17/umbraco-cms/tutorials/editors-manual/media-management/working-with-images-and-files.md +++ b/17/umbraco-cms/tutorials/editors-manual/media-management/working-with-images-and-files.md @@ -35,6 +35,12 @@ To delete a Media Item: ![mediaUpload.jpg](images/delete-media-item-v14.png) 3. Click **Trash**. +{% hint style="warning" %} +When media is moved to the recycle bin the files are still accessible on their previous, public URL. They will only be unavailable once the recycle bin is emptied or the media item is fully deleted. + +If you wish to change this behavior, please [see details on the `EnableMediaRecycleBinProtection` configuration option](../../../reference/configuration/contentsettings.md#enable-media-recycle-bin-protection). +{% endhint %} + ## Restoring a Media Item from the Recycle Bin The **Recycle Bin** is a separate tree structure within the Media section. Clicking on the arrow next to the Recycle Bin will display its contents. From 77d54d43cf2925dc87e240bc602beeff80ca5008 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Tue, 4 Nov 2025 09:32:06 +0100 Subject: [PATCH 2/3] Update 17/umbraco-cms/reference/configuration/contentsettings.md --- 17/umbraco-cms/reference/configuration/contentsettings.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/17/umbraco-cms/reference/configuration/contentsettings.md b/17/umbraco-cms/reference/configuration/contentsettings.md index 139b91957e5..5544d76789d 100644 --- a/17/umbraco-cms/reference/configuration/contentsettings.md +++ b/17/umbraco-cms/reference/configuration/contentsettings.md @@ -185,15 +185,15 @@ To suppress these warnings, set this option to `false`. ### Enable media recycle bin protection -By default, when media is moved to the recycle bin the files are still accessible on their previous, public URL. They will only be unavailable once the recycle bin is emptied or the media item is fully deleted. +By default, when media is moved to the recycle bin, the files are still accessible at their previous public URL. They will only be unavailable once the recycle bin is emptied or the media item is fully deleted. -If this is a concern, setting `EnableMediaRecycleBinProtection` to `true` will avoid this. On moving a media item to the recycle bin the file extension will be changed. The change will be reverted if the media item is restored back to it's original location. +If this is a concern, setting `EnableMediaRecycleBinProtection` to `true` will avoid this. On moving a media item to the recycle bin, the file extension will be changed. The change will be reverted if the media item is restored to its original location. -Separately a middleware component will be enabled that will prevent access to these renamed files if the user is not logged into the backoffice. +Separately, a middleware component will be enabled to prevent access to these renamed files if the user is not logged into the backoffice. When enabling this option, ensure that the media recycle bin is initially empty. -We will consider making this option enabled by default from Umbraco 18. +This option may be enabled by default from Umbraco version 18. ## Content version cleanup policy From 409c8c8f4a69ccf16a019844702fec2666504606 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Tue, 4 Nov 2025 09:32:13 +0100 Subject: [PATCH 3/3] Update 17/umbraco-cms/tutorials/editors-manual/media-management/working-with-images-and-files.md --- .../media-management/working-with-images-and-files.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/17/umbraco-cms/tutorials/editors-manual/media-management/working-with-images-and-files.md b/17/umbraco-cms/tutorials/editors-manual/media-management/working-with-images-and-files.md index cc0b746ee35..d5863931d13 100644 --- a/17/umbraco-cms/tutorials/editors-manual/media-management/working-with-images-and-files.md +++ b/17/umbraco-cms/tutorials/editors-manual/media-management/working-with-images-and-files.md @@ -36,9 +36,9 @@ To delete a Media Item: 3. Click **Trash**. {% hint style="warning" %} -When media is moved to the recycle bin the files are still accessible on their previous, public URL. They will only be unavailable once the recycle bin is emptied or the media item is fully deleted. +When media is moved to the recycle bin, the files are still accessible at their previous public URL. They will only be unavailable once the recycle bin is emptied or the media item is fully deleted. -If you wish to change this behavior, please [see details on the `EnableMediaRecycleBinProtection` configuration option](../../../reference/configuration/contentsettings.md#enable-media-recycle-bin-protection). +If you wish to change this behavior, [see details for the `EnableMediaRecycleBinProtection` configuration option](../../../reference/configuration/contentsettings.md#enable-media-recycle-bin-protection). {% endhint %} ## Restoring a Media Item from the Recycle Bin