​
Overview

Every ProBeya organization operates on its own subdomain: your-org.probeya.com. This provides complete isolation between tenants and a branded URL for your team.

​
Default Subdomain

Your subdomain is set during organization creation. It must:

  • Be between 3 and 63 characters
  • Contain only lowercase letters, numbers, and hyphens
  • Start with a letter
  • Not end with a hyphen
  • Be unique across all ProBeya organizations

​
Changing Your Subdomain

Changing your subdomain will break existing bookmarks, shared links, and API integrations. Proceed with caution.

To request a subdomain change:

  1. Go to Settings > Organization > Subdomain
  2. Enter the new subdomain
  3. Confirm availability
  4. Submit the change request

The old subdomain will redirect to the new one for 30 days. After that, the old subdomain is released.

​
Custom Domain

Business and Enterprise plans can configure a custom domain (e.g., pm.yourcompany.com) to replace the default your-org.probeya.com.

1

Add Your Domain

Go to Settings > Organization > Custom Domain and enter your desired domain (e.g., pm.yourcompany.com).

2

Configure DNS

Add a CNAME record pointing your domain to custom.probeya.com at your DNS provider.

Type:  CNAME
Name:  pm
Value: custom.probeya.com
TTL:   3600
3

Verify Domain

Click Verify in the ProBeya settings. DNS propagation can take up to 48 hours, but typically completes within minutes.

4

SSL Certificate

ProBeya automatically provisions and renews an SSL certificate for your custom domain via Let’s Encrypt. No action needed.

​
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

URLTenantLanguage
acme.probeya.comacmeUser’s browser preference
acme-fr.probeya.comacmeFrench
acme-de.probeya.comacmeGerman
acme-nl.probeya.comacmeDutch
acme-es.probeya.comacmeSpanish
acme-it.probeya.comacmeItalian
acme-en.probeya.comacmeEnglish

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

URLTenantLanguage
my-company.probeya.commy-companyBrowser preference
my-company-fr.probeya.commy-companyFrench

​
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.

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

​
Multi-Subdomain API Access

All API requests are scoped to the organization identified by the subdomain:

# Access ACME organization's data
curl https://acme.probeya.com/api/v1/boards \
  -H "Authorization: Bearer YOUR_TOKEN"

# Access Different organization's data
curl https://other-org.probeya.com/api/v1/boards \
  -H "Authorization: Bearer DIFFERENT_TOKEN"

API tokens are scoped to a single organization. A token created in acme.probeya.com cannot be used to access other-org.probeya.com.

​
Subdomain Security

  • All subdomains are served over HTTPS with automatic certificate management
  • Cookies are scoped to the specific subdomain — no cross-tenant cookie leakage
  • CORS policies are enforced per-subdomain
  • Rate limiting is applied per-subdomain to prevent abuse

​
Allowed Subdomains

The following subdomains are reserved and cannot be used:

www, app, api, admin, status, docs, help, support, blog, mail, smtp, ftp, ns1, ns2, cdn, assets, static, staging, dev, test

Was this page helpful?

Organization SetupUser Management