Subdomain architecture

Where you sign in tells PropLink who you are and which organisation you belong to. The platform uses subdomains to route each kind of user to the right interface.

The subdomains

login.proplinkcloud.com

The universal sign-in page. Anyone with PropLink admin access starts here. After signing in, the platform redirects you to your organisation's subdomain.

admin.proplinkcloud.com

For PropLink staff only, used for tenant onboarding, support and platform-wide observability. Customers never need to touch this URL.

<your-org>.proplinkcloud.com

Your organisation's main admin app. The subdomain is chosen during organisation setup, for example goldcrest.proplinkcloud.com. This is where managers, accountants and administrators do their day-to-day work.

<your-org>.residenceport.com

Your branded resident portal. Leaseholders and tenants sign in here. Each organisation gets a subdomain on residenceport.com so the portal feels like part of your firm.

<your-org>.buildingthread.com

Coming soon. The golden thread portal for residents of high-risk buildings. Same model as ResidencePort, one subdomain per organisation.

contractorport.com/<token>

ContractorPort is invitation-only. A contractor is sent a single-use signed link that opens the work-order submission form. There is no general portal home page.

What happens when you sign in

1. You open login.proplinkcloud.com.
2. You enter your email and password.
3. PropLink shows the organisations your email is linked to. Often there is only one.
4. You pick the organisation and PropLink redirects you to your-org.proplinkcloud.com/dashboard.
5. From now on, every API call and every page load carries an implicit X-Org-Subdomain header that scopes the request to your organisation.

The same flow works for ResidencePort and the Facility Report mobile app, only the start URL differs.

How the platform decides which organisation you are in

The subdomain in the URL is the source of truth. Every incoming request goes through middleware that:

1. Reads the subdomain.
2. Looks up the matching organisation.
3. Confirms the signed-in user is allowed to access that organisation.
4. Sets organisation_uuid for the duration of the request.

If any of those steps fail, the request is rejected. There is no fallback to "some other organisation" and no way to spoof another tenant by changing the URL.

Switching organisations

If you have access to several organisations:

1. Click your profile in the top right.
2. Pick Switch organisation.
3. PropLink redirects you to the chosen organisation's subdomain.

Each tab in your browser stays on the organisation it was opened against. You can have two tabs open on two different organisations safely, they share nothing.

Test domains

In development the same scheme works against proplink.test. goldcrest.proplink.test, goldcrest.residenceport.test and so on resolve to the same backend with the same tenancy rules. There is no special test-only behaviour.