Skip to main content

Manage a Tenant

Manage a tenant from the directory row actions or the tenant detail page.

On larger screens, the detail header groups Edit Tenant, Create Lease, and Actions. Archived tenants show Unarchive Tenant first, followed by Edit Tenant and Actions; Create Lease is hidden until the tenant is unarchived. Actions remain subject to their respective permissions.

On mobile, all header actions are available from Actions.

Edit a Tenant​

Select Edit from the tenant row menu or Edit Tenant in the tenant detail header. The drawer uses two sections:

  1. Tenant Details contains the tenant's name, email, phone, account status, insurance status, and image.
  2. Emergency Contact contains the primary emergency contact's name and phone number.

Select Next to move from Tenant Details to Emergency Contact, then select Save to apply the changes.

Tenant Image​

Use the Tenant Image panel to add, replace, or delete the image. Parcelis accepts JPG, PNG, and WebP files up to 2 MB. Replacing an image removes the previous image object after the replacement is recorded.

The tenant detail page displays the image once as a circular avatar. Select the avatar to open the full image in a centered preview.

Images are stored in the private MinIO bucket under organizations/{organizationId}/tenants/{tenantId}/images/{imageId}.{extension} and displayed through short-lived URLs.

Emergency Contact​

The tenant detail page shows the primary emergency contact in the Contact Information card. Select the contact's name to review their information, then select Edit Contact to update it.

You can also update the emergency contact from the tenant drawer.

Add Notes​

Select Actions → Add Notes in the tenant detail header to open the Notes drawer and store internal operating context. Tenant notes can contain up to 5,000 characters. The drawer also includes a Files tab; file attachments are not available yet. Use a note's vertical actions menu to edit or delete it.

Archive and Unarchive​

Select Actions → Archive Tenant on the detail page to remove a tenant from the normal active workflow while preserving the record and lease history. Filter the directory for Archived tenants and select Unarchive Tenant to return an archived tenant to their lease-derived Active or Past status.

Delete a Tenant​

Select Actions → Delete Tenant on the detail page only when the tenant should be permanently removed. Parcelis asks for confirmation and deletes the tenant record and associated lease history. This action cannot be undone.