> For the complete documentation index, see [llms.txt](https://islamu.gitbook.io/islamu-event/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://islamu.gitbook.io/islamu-event/documentation/readme/administration-and-branding/custom-domains-and-seo.md).
# Custom Domains & SEO
Bind tenant domains safely and operate the focused public-discovery SEO surface.
Custom vanity domains in ISLAMU Event are tenant routing and public accountability boundaries, not merely cosmetic branding aliases.
***
## Domain Setup & Tenant Routing
Before enabling an external domain for a community tenant:
1. **Verify Tenant Ownership**: Ensure the domain binding is requested by an authorized Tenant Administrator (see [Admin Hierarchy](/islamu-event/documentation/readme/administration-and-branding/admin-hierarchy.md)).
2. **DNS & TLS Provisioning**: Point DNS A/AAAA or CNAME records to your server and verify valid TLS certificate issuance.
3. **Reverse-Proxy Header Forwarding**: Ensure your reverse proxy (Caddy, Traefik, or Nginx) forwards the client `Host` and `X-Forwarded-Proto` headers (see [Docker Compose Reverse Proxy](/islamu-event/documentation/readme/self-hosting/docker-compose.md#5-reverse-proxy-configuration)).
4. **Tenant Resolution Order**: In [Multi-Tenant Mode](/islamu-event/documentation/readme/security-and-identity/multi-tenancy.md), requests evaluate: $$\text{Trusted BFF Context} \longrightarrow \text{Admin-Host Exclusion} \longrightarrow \text{Custom Domain} \longrightarrow \text{Subdomain} \longrightarrow 404$$
5. **Fail-Closed Verification**: An unmapped or unknown domain must immediately return `404 Not Found`. It will never route to a random tenant.
***
## Implemented Public SEO Surface
Search engine optimization is intentionally focused on driving organic discovery of public community events:
* **Automated `/sitemap.xml`**: Dynamically renders indexable URLs for active public events and organizations.
* **Environment-Aware `/robots.txt`**: Automatically disables indexing (`Disallow: /`) in `Development` or `Staging` environments while permitting indexing in `Production`.
* **Social Sharing Cards**: Server-rendered Open Graph (`og:image`, `og:title`) and Twitter Cards for public event detail pages.
* **Structured Data (Schema.org JSON-LD)**: Injects rich `Event` schema markup (start/end time, venue location, organizer, ticket availability) to qualify for Google Event Search cards.
* **Anti-Crawl Protections**: Administrative consoles, checkout sessions, and non-public event drafts automatically emit ``.
***
## Operational Scope & Limits
The platform automates structured metadata and search cards, but does not provide search engine ranking guarantees or Google Search Console API synchronizers. Operators remain responsible for domain reputation, DNS health, content quality, and search engine ownership verification.
***
## Related Guides & Next Steps
* [**Multi-Tenancy Architecture**](/islamu-event/documentation/readme/security-and-identity/multi-tenancy.md) — Learn how host headers resolve tenant boundaries.
* [**White-Labeling & Branding**](/islamu-event/documentation/readme/administration-and-branding/white-labeling.md) — Customize storefront appearance while preserving governance locks.
* [**Docker Compose Reverse Proxy Setup**](/islamu-event/documentation/readme/self-hosting/docker-compose.md#5-reverse-proxy-configuration) — Configure Caddy, Traefik, or Nginx for custom domains.
* [**Troubleshooting Tenant Routing**](/islamu-event/documentation/readme/configuration-and-operations/troubleshooting-and-health.md) — Diagnose 404 unknown host and redirect issues.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://islamu.gitbook.io/islamu-event/documentation/readme/administration-and-branding/custom-domains-and-seo.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.