Purpose
This article explains how to manage multiple tenancies on a property in Kamma Suite, including how each tenancy affects the licence determination.
What you'll learn
In this article, you'll learn how to:
Add, edit, and delete a tenancy when you have multi-tenancies enabled
Read the Current, Arranging and Other tenancy tables on the property page
Understand how tenancy status affects the licence required
Before you start
Multi-tenancy management is enabled for organisations that have the multi-tenancy feature switched on. If you only see fields for Occupants and Households in the Tenancy Details section of the Property Compliance Overview page then your organisation is on the single-tenancy view. Contact support if you'd like to discuss enabling multi-tenancy management at [email protected].
Understand the tenancy tables
Tenancies on the Property page are grouped into three tables under Tenancy Details:
Current Tenancy — the tenancy that is currently in place. Its occupants and households are used to determine the licence the property requires and its compliance status.
Arranging Tenancy — the tenancy that is being arranged but hasn't started yet. The licence that will be required for this tenancy is shown above the table. Hover over the information icon next the heading to see an explanation of how the licence requirement is arrived at.
Other Tenancies — finished, withdrawn, or cancelled tenancies. Collapsed by default; click the heading to expand.
A table only appears when at least one tenancy in that group exists. If a property has no tenancies at all, you'll see a message stating no tenancies exist. Click the 'Add Tenancy' button to add a tenancy.
Add a tenancy
Scroll to the Tenancy Details section on the property page
Click Add Tenancy
Choose the Status — Current, Arranging Tenancy, Finished, Withdrawn, or Cancelled
Enter the Occupants and Households for the tenancy
Optionally click + Add start / end dates and enter the tenancy dates
Dates are for your reference only. They aren't necessary to determine the licence required.Optionally click + Add contracted tenant names and enter one row per tenant. Tenant names are for visual reference only, it's the Occupant count that used for the licence determination.
Click Add Tenancy to save
Edit a tenancy
In any of the three tables, click Edit on the tenancy row
Update any of the fields — including changing the Status to move the tenancy between tables
Click Save Changes
Step 3: Delete a tenancy
Click Delete on the tenancy row
Review the tenancy summary in the confirmation dialog
Click Delete tenancy to confirm, or Cancel to back out
What happens next
The property's Compliance Status, Licence Required, and Action cards refresh based on the entries in the Current tenancy table
If you added or edited an Arranging tenancy, the Arranging Tenancy table shows the licence required when these tenants move in, based on licence schemes in place today
Tables and totals update automatically — no need to refresh the page
Important notes
Date warnings — Start and end dates render in amber with a warning icon if a Current tenancy has ended (or hasn't started yet), or if an Arranging tenancy's dates fall in the past or are already active. Hover the icon for the explanation.
Tenant names are for reference only — They're useful for context but they don't feed into the licence determination. The Occupants field is what drives the determination, and the two don't have to match.
CRM-integrated organisations — If your tenancies sync from a CRM (e.g. Reapit or GlueDog), Contracted Occupants and tenant names are read-only in the form and you'll see an extra Additional Occupants field for occupants not on the contract. Edits to those fields should be made in the CRM.
Common questions
Why does the Arranging Tenancy table show a different licence type from the Current Tenancy table?
The Arranging table runs a separate determination based only on the arranging tenancy total, so you can see what licence will be required if the tenancy goes ahead. The Current table reflects what's required right now. They may differ.
Related articles
Managing HMOs that are rented room-by-room