KB Version:

Page Navigation

Related Links

Learning Levels

Most Read

Recycle Bin

Digest

Cascade Server's Recycle Bin is a temporary holding area for deleted assets which helps prevent loss of content.  Assets in the Recycle Bin can be restored to their original location or purged from the system permanently either one at-a-time or in bulk.

Concept

What is recycled?

All Home Area Assets (Pages, Files, Folders, Blocks, Formats, Templates, and External Links) are sent to the Recycle Bin when deleted.  Once in the Recycle Bin, the assets can be permanently deleted or restored to their original location.

Are there different Recycle Bins for each Site?

Yes, each Site has its own Recycle Bin.  The Global area also has its own Recycle Bin.

What can I see and do in the Recycle Bin?

A user's abilities dictate which assets he or she can see in a particular Recycle Bin.  By default, all users are able to see and restore all assets that they have deleted.  

The new Role abilities are:

  • View and Restore only assets the current user deleted - Enabled for all users by default
  • View and Restore all assets in the Recycle Bin - Disabled by default
  • Permanently remove assets from the Recycle Bin - Disabled by default
These abilities apply to both Site and Global Roles.  This allows users to have different Recycle Bin abilities per Site. For example, a user may have the ability to permanently delete assets in Site A, but not have that ability in Site B or the Global area.
The abilities on Global Roles only apply to the Global Area's Recycle Bin.

Technical

Accessing the Recycle Bin

To access the Recycle Bin, click the link on the Dashboard or the link in Quick Links.

Accessing the Recycle Bin screenshot

Restoring Assets

To restore an individual asset back to its original location, click the green Restore icon in the Actions column.

Restore a single asset screenshot

To restore multiple assets, select the assets using the checkboxes in the left column.  Then click the "With Selected:" dropdown menu, and select Restore.

Restore multiple asset screenshot

Restoring Invalid Assets

An asset may become "invalid" if certain required relationships are broken, such as a missing parent folder or Content Type.  When trying to restore an invalid asset, the user is required to select reassignments for each broken relationship.

For example, Page A is deleted and sent to the Recycle Bin.  Later, its original parent folder is deleted.  When the user tries to restore Page A, he/she will be presented with an asset reassignment screen which allows a new parent folder to be selected before the Page is restored.

Asset restore-reassignment screenshot

The same concept applies to restoring multiple assets.

Restoring multiple invalid assets screenshot

In the multiple reassignment scenario, the user can select one reassignment for all assets or separate reassignments for individual assets.  The "for all" reassignment is applied to any assets that do not have an individual reassignment.

If there are more than 20 invalid assets, the user can only make the reassignment to all of them.

Deleting Assets

An asset is not permanently deleted until it is removed from the Recycle Bin.  To permanently delete an asset from the Recycle Bin, click the red "Delete" icon in the Actions column.

Deleting a single asset screenshot

To permanently delete multiple assets, select the assets using the checkboxes in the left column, click the "With Selected:" dropdown menu and select Delete.

Deleting multiple assets screesnhot

To permanently delete everything* in the Recycle Bin, click the Empty Recycle Bin link at the bottom of the table.

Deleting all assets screenshot

* Note that emptying the recycle bin will only permanently delete items in the current Site that are visible for the current user.

Configuring Automatic Deletion

By default, all Sites and the Global area have an expiration time of 15 days.  After an asset has been in the Recycle Bin for 15 days, it is permanently deleted automatically.  This expiration time can be changed for each  Site or the Global area individually.

The available expiration times are: 1 day, 15 days, 30 days, or Never.  When "Never" is selected, assets will remain in the Recycle Bin until manually deleted.

To change the expiration time on a Site, go to System -> Site Management.  Select a Site on the left and then click the Edit tab.   A Recycle Bin Expiration dropdown will be available at the bottom of the edit screen.

Recycle Bin expiration preference on a Site

To change the expiration preference for the Global area's Recycle Bin, go to System -> Preferences -> Content.  At the bottom of the Content tab is a Recycle Bin Expiration dropdown.  This only changes the expiration time in the Global area's Recycle Bin and not any Site.

Recycle Bin expiration preference for Global area screenshot

Entity Relations with Recycled Assets

When assets are sent to the Recycle Bin, certain relationships are maintained until permanent deletion or reassignment.  If an asset is restored, the relationship is also restored.  Relationships are maintained on Block/Format assignments for regions and asset choosers on Pages using Data Definitions.

Example:

  • A Block is assigned to the DEFAULT region on 5 different Pages. 
  • The Block is deleted (i.e. sent to the Recycle Bin)
  • When any of those 5 different Pages are rendered, the DEFAULT region does not use the Block's content.
  • On the Configurations pane (for either View or Edit tabs), the DEFAULT region shows the path to the Block with a strikethrough (see screenshot below)
  • On one of the five Pages, a User assigns a new Block to the DEFAULT region.
  • The Block is restored from the Recycle Bin
  • The 4 Pages that did not change the DEFAULT region assignment now have the Block's content in the DEFAULT region once again.
Screenshot of a region with an assignment to a Block in the Recycle Bin
The same scenario can be applied to asset choosers in a Page with a Data Definition.  Below is a screenshot of a File chooser which has a recycled File selected:
Screenshot of an asset chooser in a Data Definition
Links to assets inside of content, such as a link on a WYSIWYG, are not maintained this way. However, if the path remains the same when the asset is restored, the content link will resolve correctly in most cases.

Related Links