Subdomain Configuration

Each organization in ProBeya gets its own subdomain in the format {slug}.probeya.com. This provides a unique, branded URL for your team.

How Subdomains Work

When you create an organization with the slug acme, your team accesses ProBeya at:

https://acme.probeya.com

All links shared from your organization use this subdomain, ensuring team members land in the right place.

Choosing a Slug

Your slug must be:

• Between 3 and 63 characters.
• Lowercase letters, numbers, and hyphens only.
• Cannot start or end with a hyphen.
• Unique across all ProBeya organizations.

Choose a slug that is easy to remember and type — your team will use it every day.

Changing Your Slug

1. Navigate to Settings > Organization > General.
2. Edit the Slug field.
3. The system checks if the new slug is available.
4. Click Save.

Important: Changing your slug immediately changes your URL. All previously shared links using the old slug will stop working. Consider notifying your team before making this change.

Custom Domains (Enterprise)

Enterprise plan customers can configure a fully custom domain:

1. Navigate to Settings > Organization > Custom Domain.
2. Enter your desired domain (e.g., projects.acme.com).
3. Add the required DNS records:
   • CNAME record: Point your domain to proxy.probeya.com.
   • TXT record: Verify domain ownership with the provided token.
4. Click Verify Domain. DNS propagation can take up to 48 hours.
5. Once verified, SSL certificates are automatically provisioned.

After setup, your team can access ProBeya at both acme.probeya.com and projects.acme.com.

Locale-Suffixed Subdomains

ProBeya supports language selection directly in the subdomain URL by appending a hyphen and a two-letter locale code after the organization slug:

https://{slug}-{locale}.probeya.com

How It Works

URL	Tenant	Language
acme.probeya.com	acme	User's browser preference
acme-fr.probeya.com	acme	French
acme-de.probeya.com	acme	German
acme-nl.probeya.com	acme	Dutch
acme-es.probeya.com	acme	Spanish
acme-it.probeya.com	acme	Italian
acme-en.probeya.com	acme	English

The locale suffix is always the last hyphen-separated segment. Organization slugs containing hyphens work naturally:

URL	Tenant	Language
my-company.probeya.com	my-company	Browser preference
my-company-fr.probeya.com	my-company	French

Supported Locales

ProBeya supports thirteen languages: en (English), fr (French), nl (Dutch), de (German), it (Italian), es (Spanish), pt (Portuguese), ru (Russian), ar (Arabic, RTL), id (Indonesian), zh (Chinese), ja (Japanese), ko (Korean).

Locale Priority

When a locale-suffixed URL is used, it takes highest priority over all other locale settings:

1. Subdomain suffix — demo-fr.probeya.com forces French
2. NEXT_LOCALE cookie — set by the user's language preference in the app
3. Browser Accept-Language header — detected from the user's browser
4. Default — English

The subdomain locale also updates the user's locale cookie, so subsequent visits to the plain subdomain (e.g., demo.probeya.com) will retain the language choice.

tipp

Share locale-suffixed URLs with international teams so each person lands directly in their preferred language — no manual language switching needed.

SSL Certificates

All subdomains and custom domains use HTTPS with automatically managed SSL certificates. No configuration is needed on your part.

Subdomain Restrictions

The following slugs are reserved and cannot be used:

• www, api, app, admin, mail, docs, help, support, status, blog