Skip to main content
Skip table of contents

Scheduled Disposition Guide

This guide describes the Scheduled Disposition process in Gimmal Physical For this process to work correctly, Retention and Disposition features need to be enabled as part of the configuration when Gimmal Physical is enabled.

This guide focuses on the process for deleting records associated with Records Schedules with a Disposition Action of ‘Destroy’. Records associated with a Records Schedule with Disposition Action of ‘Permanent’ will never enter into a Disposition Batch.


  • To prevent Records associated with a Records Schedule with Disposition Action of ‘Transfer’ from entering the disposition process, the Schedule itself must be placed on Legal Hold. This will prevent the associated records from entering the disposition process.

  • This document refers to Gimmal Physical version 3.13.1 and above only. For questions on earlier versions, please contact support at

Explanation of Dates

The Scheduled Disposition process. uses several dates which are associated with physical items:

Date From

Represents the oldest date of the contents of the physical item.

Date To

Represents the most current date (or newest) date of the contents of the physical item.

Cut-off Date

Depending upon the retention schedule, this date will be automatically calculated by Gimmal Physical for a time-based schedule or a specific time + event-based schedule (calendar year) or it can be entered manually by the client.
Note: The cut-off date is sometimes referred to as the Trigger Date, or Event Date.

Scheduled Destruction Date

The scheduled destruction date is automatically calculated if a retention schedule is selected, and certain conditions are met.

Criteria used to calculate the scheduled destruction date is listed in ‘Scheduled Destruction Date Calculation’

Actual Destruction Date

The actual date the physical item was disposed based on the final steps of the disposition process.

Scheduled Destruction Date Calculation

The automated calculation for the scheduled destruction date is determined by the retention schedule (see rules below) unless it meets the following conditions:

  1. If Override is selected, no automatic calculations are performed by Gimmal Physical. In this situation, only user-entered dates can be used to determine a Scheduled Destruction Date.

  2. If the item is attached to a Permanent Records Schedule, the Scheduled Destruction Date will never be populated.

  3. Container Calculations:  Absent the above conditions, when an item is a container (e.g., a Box) and has content items with dates (e.g., a File), the dates for the contents (the Files) act as the master to determine the dates of the source container (the Box).

    1. The Scheduled Destruction Dates of the container will be the maximum of the Scheduled Destruction Date of the contents unless otherwise noted below:

      1. If the deletion or transfer of the content items empties the container, the Scheduled Destruction Date will be set to null.

      2. If any content item has a null Scheduled Destruction Date, the container will also have a null destruction date.

    2. Regardless of whether Scheduled Destruction Dates for the content items display a value, other dates will be set as follows to ensure search fidelity:

      1. Date From = Minimum ‘Date From’ of the content items in the container

      2. Date To = Maximum ‘Date To’ of the content items in the container

      3. Cut-off Date = Maximum ‘Cut-off Date’ of the content items in the container

    3. Several actions will force the recalculation of a source container. This includes:

      1.   The creation of a new content item within a container

      2.   Content items deleted from a container

      3.   Content items transferred into or out of a container.
        Note: If a content item is transferred, the container for both the source and the destination will be recalculated to conform to the remaining contents in the container.

Retention Schedules & Dates

  1. Time Based Retention Schedule is a schedule to store data for a specified interval.  When a time-based retention schedule is associated with a physical item and the Date From and Date To are entered, the Gimmal Physical application automatically calculates a Cut-off Date. The Scheduled Destruction Date is then calculated based on the listed Year, Month and Day values of the retention schedule.

  2. Event+ Time Based Retention Schedule is a schedule to store data for a specified interval after a specified event has occurred. When this type of schedule is associated with a physical item* and the Date From and Date To are entered, the user must enter an Event (aka Trigger or Cut-off) Date. The Scheduled Destruction Date is then calculated based on the listed timespan (the Year, Month and Day values) of the retention schedule.
    *There is an exception to this calculation for known events whose dates is consistently known (e.g. Fiscal Year-End or Calendar Year-End). In this case, the List Value month/day is used to calculate the cut-off date. With that date, the Scheduled Destruction Date is then calculated.
    Note: For this known events date calculation to work properly, the Event Code list value for options like Fiscal Year-End must be configured for the correct Month/Day. See ‘List Values’ section below.

  3. Event Based Retention Schedule is a rare schedule that is identical to the Event+Time above, however, the destruction will occur immediately after the event is triggered.  The timespan, in essence, is 0.

Gimmal Physical Application Disposition Process

The Disposition Process within the Gimmal Physical application consists of three distinct stages: Identification, Aggregation, and Disposition.

Each one of these stages comes with its own set of reports and a specific set of requirements to be met to proceed through the disposition process.

  • The Identification Stage comes with the disposition approval reports.  There is an Approval Report for each functional unit, department or organization involved.

  • The Aggregation Stage comes with the Disposition Picklist Report.  There is a Picklist Report for each facility’s housing records.

  • The Disposition Stage comes with the Certificates of Destruction for each functional unit, department or organization involved.

Based on conversations during the application configuration, disposition can be run at the container (e.g. box) or contents (e.g. file) level.

Identification Stage

To be included in a disposition batch, an item cannot be on a Legal Hold or already deleted. The specific items must then meet the criteria of the specified Target Date and have a related Organization, Location or both as chosen by the filters. If the criteria is only a specified Target Date (i.e. no filters are used), this identification will be run across all Organizations and Locations.

In the example below, Boxes will be used.

Ready to Proceed: Boxes Tab > Change > Retention

  1. Proceed to the Boxes Tab.

  2. Choose the Change button in the action menu

  3. Select the Retention menu option to begin the disposition process.

The Box Retention view will open.  At this point batches may or may not have been run yet. A batch is simply a grouping of the items that meet this disposition criteria.  Once you run a batch, a grid will appear to manage the previously run batches or in process batches.

There is a helpful information bubble up at the top of the page that will highlight the step being activated within the process.

To begin disposition:

  1. Enter the Target Date by typing directly or using the calendar control.

  2. Choose to filter by one or more Organizations (optional).

  3. Choose to filter by one or more Locations (optional).
    Please note: only Hub locations are available as a filter option for disposition.

  4. Select Execute, then click ‘OK’ on the subsequent verification page

A pop up will appear to let you know the process is being run.

Once the batch processing is complete, the Box Retention page will be updated with details of the new batch. A new, automated, batch number is assigned for all boxes which met the disposition criteria.

Note:  Boxes can be removed from the batch if they should not be destroyed or need further review. To do so, use the linked queries to show the list of boxes in the batch. Use the update options (single or in bulk) to remove the batch number for the specified boxes.

To proceed to approval, the report can be queried for review from the Query Reports.

To view Query Reports, go to Boxes > Change > Retention.

Batch numbers have been designated on each item and are ready for approval.

Approval Tips:

  1. Some clients require a user to access the Gimmal Physical application and approve the disposition of the boxes. They can be approved individually or a selected set via Update or Bulk Update.

  2. Other clients share the reports via email or hard copy to the appropriate personnel for responses. In this case, the Gimmal Physical Administrator manually enter the approvals into the application based on the responses they receive.

  3. Multiple approval levels can be added to the Gimmal Physical application, however, access to the levels cannot be separated out based on role.

    1. Proceed to  Admin > List Values > Disposition Approval > Add New Field to force an order for approvals.

    2. We recommend adding a digit with a hyphen (e.g. 1-, 2-, 3)- to the value name, to maintain a logical order, otherwise the list will sort alphabetically.

The boxes which are approved can now move to the Aggregation Stage.

Helpful Tips for the Identification Stage:

  • For more control, or a smaller number of boxes to approve:

    • Eliminate boxes on Legal Hold

    • Filter by Organization, Location or both

  • If a large backlog of items exists, run batches in years and months for easier management.

  • To provide a count for boxes that are ready for deletion before initiating the retention process, search the Boxes Tab based on the following criteria:

    •  Not deleted (Deleted set to false),

    • Not on a legal hold (Legal Hold set to false)

    • Enter a particular scheduled date with the appropriate comparison operator (usually less than <).

  • To see box level detail like the Disposition Notice showing the current Stage/Batch and the Disposition Approval checkbox, simply view the Box. Please note that changes to this information are recorded in history.

  • If a File belongs in a Box, but is checked out when the Box is destroyed through a Disposition Batch, the File is not deleted, but its Home Location is removed. The file will inherit a new Home Location based on the next Box it gets put into.

Aggregation Stage

Ready to Proceed: Boxes Tab > Change > Retention

Select the radio button on the Identification Stage and click Execute to move to the Aggregation Stage for the selected batch.

All boxes approved for disposition should be physically moved from the shelves and set aside to a Disposition Staging Location. To facilitate this activity, the Disposition Picklist Report can be used.

Transfer boxes to the Disposition Staging Location within the Gimmal Physical application. This can be accomplished by a barcode scanner or by manually updating the system.

If you are using off-site storage vendor (and not using any Gimmal Off-Site Storage Connectors), you should provide this information to your off-site vendor for disposition.

Helpful Tips

  • A barcode scanner can be used to transfer the boxes to the Disposition Staging Location. This is an opportunity to confirm that all the correct boxes have been pulled for destruction.

  • There is a helpful information bubble up at the top of the page that will highlight the step being activated within the process.

  • A Disposition Staging Location needs to be created within the application under Locations and the checkbox “Is Disposition Staging Location” needs to be enabled for the chosen Location(s).

Disposition Stage

Ready to Proceed: Boxes Tab > Change > Retention

Select the radio button on the Aggregation Stage for the batch you wish to dispose of, then click the Execute button to move to the Disposition Stage.

Gimmal Physical will mark the items that have been deleted and assign them an actual destruction date.

Certificate of Destruction will be located on the Disposition Notices Tab. It is in PDF format which can be opened to view the information.

Adding List Values

Certain Event Codes require additional information which is stored as part of the list value entry. List Values are managed in Admin > Data > List Values.

  1. To add values to the Event Code, select the appropriate ‘Event Code’ from the "List to modify" drop down box.

  2. To modify an existing value, select it from the ‘Values already in the list’ control.

  3. Type the name of the value you wish to add in the 'Value to Add' text box.

  4. If the Event Code value has an associated Month and Day, enter them into the Month/Day text column in a MM/DD format (where MM = the static month of the event and DD = the specific static day of the month for the event)

  5.  Finally, click the 'Add' button or press the enter key.



Please contact Gimmal Support at with any questions.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.