Leasing & Tenants
Programs
A program represents a housing authority or subsidy source — for example a PHA (Public Housing Authority) administering Section 8 / Housing Choice Voucher payments. When a lease is subsidized, the rent is split: the tenant pays their portion and the program pays the subsidy portion. You manage programs under Programs (PHA) at /admin/programs.
How program-billed rent works
On a lease, turn on the Section 8 option and select the program. You then enter the rent split:
- Tenant portion — the share the tenant pays each period.
- Section 8 portion — the share the program/subsidy pays.
These add up to the lease's approved contract rent. RentAxis then bills each side separately: the tenant gets an invoice for their portion, and the program gets an invoice for the subsidy portion. On the tenant's page and reports, the tenant's outstanding balance and monthly rent reflect their portion only.
Note
Program invoices are receivable invoices with billed_to_type = program. That keeps the program's balance and ledger separate from the tenant's, even though both come from the same lease.
The Programs list
The Programs page lists each program with its type, contact person, email, phone, the number of leases attached, and the program's outstanding balance. Search across name, type, contact, email and phone, or filter by type.
Create a program
- Click Add program (or Create).
- Enter the program name (required).
- Optionally add the type (e.g. Section 8), address, contact person, email, phone, and notes.
- Save.
Tip
You can also create a program on the fly from the lease form when you mark a lease as Section 8 — handy when a new housing authority comes up mid-lease.
A program's page
Open a program to see:
- Details — contact info, type and notes.
- Leases — every lease tied to this program, with tenant, unit, term, status and contract rent.
- Invoices — the receivable invoices billed to the program.
- Outstanding balance — what the program still owes.
Program ledger
The Ledger view is a running transaction history for the program: each invoice charge and each payment applied to it, sorted chronologically with a running balance. Filter by date range, entry type (Charge / Payment) or search. Summary totals show total charges, total payments and the current balance.
Editing and archiving
Edit a program any time to update its contact details. Deleting a program archives it (soft delete) — its historical leases and invoices are preserved.