All Docs
FeaturesDepositClearUpdated March 14, 2026

Smarter Deposit Defaults in the Tenancy Creation Wizard

Smarter Deposit Defaults in the Tenancy Creation Wizard

Release: v0.1.331

What's New

The Tenancy Creation Wizard now intelligently pre-fills the deposit amount field using the Tenant Fees Act 5-week cap the moment a rent amount is entered. This removes a repetitive manual step and reduces the risk of agents entering a non-compliant deposit figure.


How It Works

When completing Step 2 of the Add Tenancy wizard:

  1. Enter a monthly rent amount in the Rent Amount field.
  2. If the Deposit Amount field is currently empty, it will be automatically populated with the 5-week cap.
  3. A hint beneath the field reads (auto-calculated, editable) to signal that the value is a suggestion, not a restriction.
  4. You can edit, clear, or override the deposit amount freely at any point.

Deposit Cap Formula

The pre-filled amount is calculated in line with the Tenant Fees Act 2019:

Deposit Cap = (Annual Rent / 52) × 5
             = (Monthly Rent × 12 / 52) × 5

Example:

Monthly RentAnnual Rent5-Week Cap
£1,000£12,000£1,153.85
£1,500£18,000£1,730.77
£2,000£24,000£2,307.69

Why This Matters

  • Reduces manual effort — Agents no longer need to calculate and type the deposit amount themselves.
  • Prevents compliance errors — The default is always the legal cap, reducing the risk of accidentally setting a deposit above the Tenant Fees Act limit.
  • Non-destructive — The auto-fill only triggers when the deposit field is empty, so existing values entered by the agent are never overwritten.
  • Transparent — The (auto-calculated, editable) label ensures agents always know the value originated from an automatic calculation, not a manual entry.

Affected Component

FileLocation
src/app/dashboard/tenancies/tenancies-list.tsxAddTenancySlideOver — Step 2, deposit amount field