Home / architect / multi-site-architecture

multi-site-architecture

Use when designing a strategy for multiple Experience Cloud sites within one Salesforce org, selecting a domain and URL pattern, planning shared LWC component libraries, designing cross-site navigation, managing the org's 100-site quota, or deciding between multi-site vs multi-org for portal needs.

• v1.0.0
• Salesforce Spring '25+
• Updated 2026-04-06
• Security
• Scalability
• Operational Excellence

• experience-cloud
• multi-site
• domain-strategy
• community-portals
• cross-site-navigation
• lwc-reuse
• cdn
• site-quota
• digital-experience
• architecture-decision

Open the skill folder on GitHub

Use this skill when designing or reviewing a strategy for deploying multiple Experience Cloud sites within a single Salesforce org. It covers quota management, domain configuration, shared component architecture, cross-site navigation patterns, license planning, and the decision between multi-site and multi-org. It does not cover single-site setup, deep component development, or unrelated multi-org architecture.

Before Starting

Gather this context before working on anything in this domain:

• Current site inventory: Run Setup > Digital Experiences > All Sites and count active, preview, and inactive sites, plus any Visualforce sites. All of those count toward the 100-site org limit. Archived sites do not — count them separately, and note that archiving is the reversible way to reclaim a slot.
• Org edition: Custom domain configuration on Experience Cloud requires Enterprise edition or higher. Professional edition orgs are limited to the default MyDomainName.my.site.com URL pattern.
• License types purchased: Experience Cloud licensing is per user and per site type (Customer Community, Partner Community, Employee Apps, etc.). A user with a Customer Community license cannot access a Partner Community site.
• Is this actually a multi-org question? If the requirement is data residency, regulatory isolation, or M&A integration, use architect/multi-org-strategy instead. Multi-site within one org assumes a shared data model.

Core Concepts

The 100-Site Org Limit

Every Salesforce org supports a maximum of 100 Experience Cloud sites. This limit is cumulative across all site statuses:

• Active sites (published and accessible to users) count toward the limit.
• Preview sites (published to admins only, not yet public) count toward the limit.
• Inactive sites (deactivated but not deleted) count toward the limit.
• Visualforce sites count toward the limit too — the quota is not Experience-Builder-only.

Salesforce's wording is: "You can have up to 100 Experience Cloud sites in your org. Active, inactive, and preview sites, including Visualforce sites, count against this limit. Archived sites don't count against this limit."

That last sentence is the one that matters operationally. Deactivating does not free a slot, but archiving does — and archiving is reversible, whereas deletion is not. Orgs that have used the site builder repeatedly for demos, proofs of concept and abandoned prototypes accumulate inactive sites that silently consume quota, and the fix is to archive them, not to destroy them.

Practical implication: treat the 100-site limit as a capacity constraint that must be actively monitored. Build a site inventory process. When a site is no longer needed, archive it — that reclaims the quota slot while preserving the site should it be needed again. Reserve permanent deletion for sites you are certain will never be revived.

Domain Strategy and Custom Domains

Every Experience Cloud site has a URL. The structure differs depending on whether a custom domain has been configured.

Default URL pattern (all editions): https://MyDomainName.my.site.com/SiteName

• MyDomainName is the org's My Domain name.
• SiteName is the site-specific path segment, set at site creation.
• This pattern is available in all editions and requires no additional setup.

Custom domain pattern (Enterprise+ only): https://portal.company.com/SiteName or https://portal.company.com/

• Configured via Setup > Custom URLs in the production org.
• Custom domains require a valid SSL certificate and DNS CNAME configuration pointing to the Salesforce CDN endpoint.
• Custom domain configuration must be done in production. Sandbox orgs use the default *.sandbox.my.site.com URL pattern and do not support custom domain configuration.
• Custom domains are applied at the org level; individual site paths remain configurable.

CDN: Experience Builder sites automatically receive CDN caching starting in Winter '19. This applies to Lightning-based Experience Builder sites on custom domains. The CDN caches static assets and page content at edge nodes. No manual CDN configuration is required.

Shared Component Architecture

Experience Cloud sites are separate deployments but they run in the same org and can consume the same Salesforce metadata — including LWC components, Apex classes, permission sets, and custom objects.

What can be shared across sites:

• LWC components deployed to the org are available in Experience Builder for any site (if the component is declared isExposed: true in the component's .js-meta.xml).
• Apex classes backing shared components are shared automatically — they are org-scoped.
• Custom objects, fields, and relationships are shared across all sites in the org.
• Flows built with Run in System Context can be reused across sites.

What is site-specific:

• Experience Builder theme, layout, and navigation are per-site.
• Guest user profile is per-site. Guest user permissions must be configured independently for each site.
• Site-level security settings (clickjack protection, CSP, HTTPS enforcement) are per-site.
• CDN cache settings and custom domain binding are per-site.

Theme layouts are the primary reuse mechanism within a single site — they allow consistent header/footer/navigation across pages of that site. They do not natively span multiple sites. Shared navigation across sites requires explicit linking.

Cross-Site Navigation

There is no native Salesforce feature for automatic cross-portal navigation or session hand-off between Experience Cloud sites. When a user navigates from one site to another:

• They are leaving one site's URL context and entering another's.
• Authenticated sessions are not automatically transferred. A user authenticated in Site A will need to authenticate separately in Site B unless SSO is configured.
• Navigation is implemented using explicit hyperlinks (web links, rich text components, or custom LWC navigation) pointing to the target site's URL.

For orgs using a single IdP for SSO, a user can navigate between sites without re-entering credentials if both sites are configured as Service Providers registered with the same IdP. The user will receive a new SAML assertion for the destination site transparently if the IdP already has an active session.

Without SSO, cross-site navigation drops the user to the target site's login page. Design navigation UI and user journeys to account for this boundary.

Common Patterns

Pattern 1: Audience-Segmented Site Topology

When to use: The org needs separate portals for distinct audience types — for example, a customer self-service portal, a partner deal registration portal, and an employee benefits portal — each requiring different branding, navigation, and access controls.

How it works:

• Create one site per audience type. Each site has its own theme, navigation, and guest/authenticated user profile.
• All sites share the same underlying Salesforce data model, custom objects, and LWC component library.
• Build reusable LWC components with audience-neutral logic and configure the experience (labels, links, display rules) via component properties or custom metadata per site.
• Assign users the license type that matches the site audience: Customer Community Plus for customer sites, Partner Community for partner sites.
• Apply separate sharing rules and permission sets per audience to control record visibility — the data model is shared but access is governed per site.

Why not the alternative: Trying to serve multiple audiences in a single site using conditional rendering and permission-based page variants is technically possible but produces unmanageable complexity. Separate sites allow distinct guest profiles, clean URL branding, and independent release cadences.

Pattern 2: Regional Sub-Portal with Shared Component Library

When to use: A global org needs multiple regional sites (EMEA, APAC, AMER) that share branding standards and component logic but require regional customization of language, content, and compliance copy.

How it works:

1. Build a shared LWC component library targeted for Experience Cloud (isExposed: true).
2. Use component properties (@api decorated attributes) to externalize configurable content — labels, links, legal disclaimers — so Experience Builder admins can configure each site without code changes.
3. For translated content, enable Translation Workbench and use the Language Switcher component within each site. The component library does not need to duplicate content per region.
4. Assign unique SiteName path segments per region (e.g., /emea, /apac, /amer) under the same custom domain base URL, or use separate CNAME subdomains per region.
5. Maintain a single deployment pipeline that pushes shared LWC components to all sites simultaneously via a Salesforce DX project structure.

Why not the alternative: Forking separate LWC code per site produces drift and doubles (or triples) maintenance overhead. Component property externalization is the correct abstraction point.

Decision Guidance

Recommended Workflow

Step-by-step instructions for an AI agent or practitioner activating this skill:

1. Inventory the current org. Count active, preview, and inactive sites in Setup > Digital Experiences > All Sites. Confirm the org edition. Determine how many of the 100-site quota remain. Identify any obsolete or prototype sites that should be archived before the project begins — archiving frees the slot without destroying the configuration.
2. Define audience segments and site boundaries. For each distinct audience (customers, partners, employees, public), determine whether a separate site is required or whether a single site with permission-based access can serve the need. Document the site topology with audience, license type, URL pattern, and guest vs authenticated access model.
3. Design the domain strategy. Decide between default my.site.com URLs and custom domains. If custom domains are required, confirm Enterprise+ edition and note that configuration happens in production only. Define the URL path segment naming convention for all planned sites.
4. Design the shared component library. Identify which LWC components will be reused across sites. Ensure components use @api properties to externalize configurable content. Confirm isExposed: true in each component's .js-meta.xml. Review guest user profile permissions per site — shared components must handle the widest permission set safely.
5. Design cross-site navigation and user journeys. For each user journey that crosses site boundaries, document the source URL, target URL, and authentication state at the boundary. Determine whether SSO via an external IdP is in scope. If not, design the UX to surface the login context clearly when the user arrives at the destination site.
6. Validate and document. Run through the Review Checklist below. Record the site topology, domain strategy, and component architecture in the project's architecture decision record. Confirm the license allocation is consistent with the site audience types.

Review Checklist

Run through these before marking work in this area complete:

• [ ] Site inventory completed: active + preview + inactive count (including Visualforce sites) is below 100. Archived sites are correctly excluded from the count. Unused sites are archived — deactivation does not free a slot, and deletion is not required to free one.
• [ ] Org edition confirmed: if custom domains are required, org is Enterprise edition or higher.
• [ ] Custom domain configuration is documented as production-only. Sandbox testing uses default .sandbox.my.site.com URL.
• [ ] Each site has a documented audience type with the corresponding license type (Customer Community, Partner Community, Employee Community, etc.).
• [ ] Guest user profile for each site is configured independently and follows the least-privilege principle.
• [ ] Shared LWC components are marked isExposed: true and use @api properties for per-site customization. No hard-coded site-specific content in shared component logic.
• [ ] Cross-site navigation is implemented as explicit hyperlinks. The behavior when an unauthenticated user follows a cross-site link is documented and user-tested.
• [ ] If SSO is used for transparent cross-site auth, each site is registered as a separate Service Provider in the IdP.
• [ ] Site-level security settings (CSP, HTTPS enforcement, clickjack protection) are reviewed and configured for each site individually.
• [ ] CDN enablement is confirmed for Experience Builder sites (automatic post-Winter '19; no manual steps required).

Salesforce-Specific Gotchas

Non-obvious platform behaviors that cause real production problems:

1. Preview sites consume the 100-site quota. Teams routinely create preview versions of upcoming site refreshes, accumulate them across multiple projects, and then discover the org is approaching 100 sites. A preview site that is never published still counts until it is archived or deleted. Establish a practice of archiving preview sites when the associated project is closed.
2. Deactivating a site does not free the quota — archiving does. An inactive (deactivated) site still counts toward the 100-site limit, alongside active and preview sites and Visualforce sites. Archived sites do not count. So the slot-reclaiming action is archive, not delete: it is reversible and it costs nothing. Orgs running Experience Cloud since the Community Cloud era frequently carry double-digit counts of inactive sites that silently consume quota, and the remedy is an archive sweep, not a deletion sweep.
3. Custom domain configuration cannot be done in sandbox. Teams that try to configure custom domains (Setup > Custom URLs) in a sandbox org will find the option either missing or non-functional. Custom domain configuration must be performed in the production org. Sandbox sites use the default .sandbox.my.site.com URL pattern. Plan UAT and pre-production testing around this constraint.
4. Cross-site navigation does not transfer the authenticated session. There is no native Salesforce capability that allows a user authenticated in one Experience Cloud site to follow a link and arrive authenticated in another site. Without SSO configured against an external IdP, the user arrives at the destination site's login page. User journeys that cross site boundaries must account for this re-authentication step.
5. Guest user profiles are per-site and are not inherited from a shared profile. A common mistake is assuming that a permission granted to one site's guest user profile applies to all sites, or that there is a single guest profile to manage. Each site has its own guest user record and guest user profile. Shared LWC components that rely on guest access must be tested against each site's guest profile independently.
6. License types are not interchangeable across site audiences. A user with a Customer Community license cannot access a Partner Community site. A user with a Partner Community license can access a Customer Community site but consumes a Partner Community license to do so. Mixing license types across audiences in a single site is not the intended design and creates license audit risk.

Output Artifacts

Related Skills

• architect/multi-org-strategy — use when data residency, regulatory isolation, or M&A requirements make single-org untenable; this is the escalation path when multi-site within one org is insufficient
• architect/experience-cloud-licensing-model — use for detailed Experience Cloud license selection, permission set licenses, and usage allocation
• admin/experience-cloud-site-setup — use for setting up a single Experience Cloud site from scratch (this skill covers multi-site strategy, not initial site provisioning)
• flow/flow-for-experience-cloud — use when designing flows that run in the context of Experience Cloud sites, including guest-user flow behavior
• admin/multi-language-and-translation — use when regional multi-site deployments require translation and localization

Package files

• references/examples.md
• references/gotchas.md
• references/llm-anti-patterns.md
• references/well-architected.md
• templates/multi-site-architecture-template.md
• scripts/check_multi_site_architecture.py