All Docs
FeaturesDepositClearUpdated March 13, 2026

Deposit Release: Bulk 'Start All Releases' Action

Deposit Release: Bulk 'Start All Releases' Action

Available from: v0.1.289

Overview

When multiple tenancies are simultaneously in a ready state — meaning they have ended, have a finalised checkout, and have no existing deposit release record — the platform now offers a single-click bulk action to start all of their deposit releases at once.

Previously, agents had to open a search modal and locate each ready tenancy manually, even though the system already knew exactly which tenancies were ready.

What "Ready" Means

A tenancy is considered ready for deposit release when all three of the following are true:

  1. Tenancy has ended — the end date has passed.
  2. Checkout has been finalised — an inspection or checkout report has been completed and signed off.
  3. No existing release record — a deposit release has not already been initiated for this tenancy.

The platform identifies these tenancies automatically via the listTenanciesForRelease query.

How It Works

Single Ready Tenancy (readyCount = 1)

Behaviour is unchanged from previous versions. The ReadyCTABanner shows a 'Start release' button that navigates directly to the tenancy detail page on the deposit release tab.

Multiple Ready Tenancies (readyCount > 1)

The ReadyCTABanner now displays a 'Start all N releases' button.

Clicking 'Start all N releases':

  1. Triggers the new bulk mutation, passing all ready tenancy IDs in a single call.
  2. The mutation creates a draft deposit release record for each tenancy in sequence.
  3. You are navigated to a batch review page where all draft releases are listed for final review and confirmation before they are submitted.
ReadyCTABanner (readyCount > 1)
  └── 'Start all N releases' button
        └── startAllReleases(tenancyIds: string[])
              └── Creates draft DepositRelease per tenancy
                    └── Navigate → Batch Review Page

Batch Review Page

The batch review page gives you a consolidated view of all draft deposit releases created by the bulk action. From here you can:

  • Review the details of each draft release before it is formally submitted.
  • Remove individual tenancies from the batch if they should not proceed at this time.
  • Confirm and submit all releases together.

Frequently Asked Questions

Q: Will this automatically submit or finalise the releases? No. The bulk action creates draft records only. No release is submitted or communicated to any party until you review and confirm on the batch review page.

Q: What if one tenancy in the batch fails to create a draft? The mutation processes tenancies in sequence. If a record cannot be created for a particular tenancy, the remaining tenancies are still processed. Failed items will be flagged on the batch review page.

Q: Does this affect single-tenancy workflows? No. When only one tenancy is ready, the existing 'Start release' button and flow remain exactly the same.

Q: Which tenancies are included in the bulk action? All tenancies currently returned as ready by listTenanciesForRelease — i.e. all tenancies meeting the three criteria above at the time the button is clicked.

Related