> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-Tenant Host & URL Strategy — Integration

> Feature ID: PF-81 Status: \U0001F4CB Specification -multi-tenant-host-url-strategy.md Last Updated: 2026-03-25

**Feature ID:** PF-81\
**Status:** 📋 Specification\
**Spec:** [PF-81-multi-tenant-host-url-strategy.md](../../../specs/pf/specs/PF-81-multi-tenant-host-url-strategy.md)\
**Last Updated:** 2026-03-25

***

## Overview

PF-81 is the **single overview** of how organization resolution, URLs, and hosts work together for the Encore Health OS platform. It does not define database, API, or UI; implementation lives in **PF-74** (path-based org routing), **PF-77** (tenant domain management), and [canonical-host-policy.md](../../../docs/development/canonical-host-policy.md). This doc ties the strategy to those specs and to the integration matrix.

**PF-95 (tenant subdomains):** Operational redirect rules (primary host → tenant `*.apex` when verified) are specified in [PF-95](../../../specs/pf/specs/PF-95-tenant-white-labeling-theming.md) as the **Canonical redirect matrix**; PF-81 remains the strategy umbrella, PF-74 implements redirects, PF-95 owns eligibility flags on `pf_organizations`.

***

## Integration Points (from Spec)

| Point                      | Type               | Document / Spec                                                                                      |
| -------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------- |
| Path-based org routing     | PF feature (PF-74) | [PF-74: Organization URL Routing](../../../specs/pf/specs/PF-74-organization-url-routing.md)         |
| Custom domains & lifecycle | PF feature (PF-77) | [PF-77: Tenant Domain Management](../../../specs/pf/specs/PF-77-tenant-domain-management.md)         |
| Canonical host policy      | Platform doc       | [canonical-host-policy.md](../../../docs/development/canonical-host-policy.md)                       |
| Vercel domain management   | External           | [Vercel: Domain management for multi-tenant](https://vercel.com/docs/multi-tenant/domain-management) |

**Cross-core:** None. PF-81 is PF-only and reference-only.

***

## Platform Layer / Event / API Contracts

No platform layer, event, or API contracts are defined by PF-81. Routing and domain behavior are implemented per PF-74 and PF-77; canonical host behavior is documented in canonical-host-policy.

***

## Related Docs

* [CROSS\_CORE\_INTEGRATIONS.md](./CROSS_CORE_INTEGRATIONS.md)
* [PF-74: Organization URL Routing](../../../specs/pf/specs/PF-74-organization-url-routing.md) — path-based routing, slug resolution
* [PF-77: Tenant Domain Management](../../../specs/pf/specs/PF-77-tenant-domain-management.md) — custom domain lifecycle, Vercel integration
* [canonical-host-policy.md](../../../docs/development/canonical-host-policy.md) — apex vs www, subdomain vs custom domain