Mobile App — Install & Sign In

How a surveyor installs the HousingSurvey Pro mobile app, signs in, and (if they work for more than one organisation) switches between profiles. Written in tiers — Basics to get going, Deep dive for multi-tenant use, Technical for IT.

Rollout note: email sign-in is live today. The tenant login (username/code + passcode, no email) and the multi-profile switcher are rolling out — this page documents the intended flow; check your dashboard for current availability.

---

Basics — signing in

You can be set up in one of two ways. Your organisation will tell you which.

Option A — you have an email account

1. Install the app and open it.
2. Enter your email and password.
3. Tap Sign in. Your assigned jobs appear in the inbox.

Option B — you have a tenant login (no email)

Some surveyors and contractors are set up with a tenant login instead of an email — created for you by your organisation's admin.

1. Install the app and open it.
2. Enter your organisation code, your username/code, and your passcode (all provided by your admin).
3. Tap Sign in.

Forgotten your passcode? Your organisation's admin resets it from the management dashboard — there is no public reset for tenant logins.

---

Deep dive — working for more than one organisation

If you carry out surveys for several companies or housing associations, you can hold a separate profile for each one and switch between them:

1. Sign in to your first organisation as above.
2. From the account menu, choose Add another profile and sign in with the second organisation's details (email, or its tenant code + username + passcode).
3. Switch profiles any time from the account menu.

Each profile is scoped to one organisation. You only ever see the jobs, data and settings of the profile you're currently in — profiles never mix.

---

Technical — for IT managers

• Identity: authentication is handled by Firebase Auth / Identity Platform. Email and SSO users authenticate directly; tenant (username/code) logins are provisioned by a tenant admin and map to a managed identity behind the scenes, so the same security rules and audit apply to every sign-in type.
• SSO: if your organisation uses Microsoft Entra ID, staff can sign in with their corporate identity — see Integrations — SSO.
• Multi-tenancy: one person may belong to multiple organisations; each app profile is a distinct tenant session. Email accounts can span tenants as multiple memberships; code-based logins are tenant-scoped.
• Device security: the app attests via App Check (App Attest on iOS, Play Integrity on Android). A lost device can be cut off centrally — an admin can remotely revoke a user's sessions from the dashboard.
• Offline: after first sign-in the app works offline; captured evidence syncs when connectivity returns.

---

Next: Mobile capture app — running a survey (in progress), or back to the help index.