Which plans include a workspace address?

Pro and Team. The Owner or an Admin picks it on the Branding page.

Is this the same as a custom domain?

No. A workspace address is a name on appforshare.io, such as acme.appforshare.io. A custom domain of your own, such as beta.acme.com, and white label pages are part of Team.

I have a Team custom domain. Which one do new links use?

The custom domain, while it is live. The workspace address still answers for links made with it.

Do my old links stop working?

No. Links on appforshare.io keep working. Only new links of the workspace use the address.

Do testers or members sign in on the workspace address?

No. Sign in stays on appforshare.io, and sessions never reach workspace addresses. Testers do not need an account to install.

Can my AI assistant set it?

No. There is no MCP tool for it, and the CLI only reads it with appforshare whoami. It is set in the dashboard.

AppForShare Open Branding

Docs

Workspace address

Share install links on your own address at appforshare.io, such as acme.appforshare.io/k3Xa9q. Testers see your workspace name and icon at the top of the page. Pro and Team.

Pick the address

Dashboard, Branding, Workspace address. The Owner or an Admin types the name, and can set the name shown in the page header (empty uses the workspace name) and a square icon (PNG, JPEG or WebP up to 2 MB). Press Use this address. Stop using it removes the address from new links.

3 to 30 characters: letters, digits and hyphens.
Reserved words, our own host names and other companies' brand names are refused.
A name you stop using is never given to another workspace, so old links cannot point at someone else.
Unknown names answer with a 404 page.

Which pages answer there

Install pages, channel pages, build history pages and join pages of your workspace answer on the address, with the workspace name and icon in the header. "Shared with AppForShare" stays on the page. Pages of other workspaces do not answer on your address.

New links, old links and a custom domain

New links of the workspace use the address: the build page, the CLI, the CI API, emails to testers and QR codes.
Links you already shared on appforshare.io keep working.
On Team, a custom domain wins for new links while it is live.
Sign in stays on appforshare.io. Sessions never reach a workspace address.

CLI

appforshare whoami prints the address of the workspace. It is read only there.

$ npx appforshare whoami
[email protected] in Acme (owner), plan pro
Workspace address: acme.appforshare.io

Questions

Which plans include a workspace address?: Pro and Team. The Owner or an Admin picks it on the Branding page.
Is this the same as a custom domain?: No. A workspace address is a name on appforshare.io, such as acme.appforshare.io. A custom domain of your own, such as beta.acme.com, and white label pages are part of Team.
I have a Team custom domain. Which one do new links use?: The custom domain, while it is live. The workspace address still answers for links made with it.
Do my old links stop working?: No. Links on appforshare.io keep working. Only new links of the workspace use the address.
Do testers or members sign in on the workspace address?: No. Sign in stays on appforshare.io, and sessions never reach workspace addresses. Testers do not need an account to install.
Can my AI assistant set it?: No. There is no MCP tool for it, and the CLI only reads it with appforshare whoami. It is set in the dashboard.

Overview: workspace address. Related: plans, upload from CI.