Branding & white-labelling

Stoa is white-label by design. You can replace the product name, tagline, and logo with your own so the platform looks and feels like part of your organization. This page covers how to set your branding and what the limits are.

What you can customize

From the admin Branding screen you can set:

• Product name (brand label). The text shown in the sidebar, the browser tab, the page titles, and outbound email. Most customers set this to their internal product name (for example, "Acme Research Assistant" or "Riverside Knowledge Hub").
• Tagline. A short subtitle shown under the brand label on the sign-in page. Optional. Use it for a one-line description ("Internal AI workspace for Acme Research") or leave it blank.
• Logo image. The logo shown in the sidebar and on the sign-in page. Replaces the default mark.

Together these three settings let you stand up a deployment that doesn't visibly reference Stoa anywhere your end users will see.

Setting your branding

1. In the admin UI, open the user menu, choose System, then select the Branding tab.
2. Type your Product name in the brand label field.
3. Optionally enter a Tagline.
4. Click Upload logo and pick the image file you want to use.
5. Preview the result in the panel on the right.
6. Click Save.

The new branding takes effect immediately for everyone signed into the platform. Open users may need to refresh their browser tab to pick up the new logo.

Logo requirements

The logo upload accepts:

• File size: up to 2MB.
• Formats: SVG, PNG, JPG, or WebP.
• Aspect ratio: square works best. The platform scales the image to fit the sidebar slot.
• Transparency: SVG and PNG support a transparent background, which is recommended so the logo blends with both light and dark themes.

TIP

SVG is the best choice for crisp rendering at every screen size. If you only have a raster logo, export it at 2x or 3x resolution before uploading so it stays sharp on high-DPI displays.

Removing your logo

The Branding screen has a Remove logo action that clears the uploaded image and falls back to the default mark, without touching your product name or tagline. There's no single action that resets everything at once: to fully revert to stock branding, clear the product name and tagline fields yourself, save, and remove the logo.

When to set branding

The right time to set branding is before you onboard your first end users, and before you turn on Active Directory provisioning. The first thing a new user sees is either the sign-in page or a welcome email, and both reflect the current branding. If your branding isn't set the first time someone signs in, that's the impression they get.

For internet-connected deployments, you can change branding any time. For air-gapped deployments, you can also change branding any time: branding lives in the database, not in the build, so no on-site visit is required to update it.

Branding in outbound email

Welcome emails and approval requests use your configured product name in the subject line and body. Make sure your branding is set before SMTP is enabled, so the very first welcome email matches the rest of your deployment.

Next

• Email (SMTP) so outbound mail picks up your brand.
• Active Directory so user provisioning happens against the right brand.
• Installation for the broader post-delivery setup checklist.