Branding and access

On the Platform settings page you set how the portal looks to your customers and who can sign up. Only staff with the owner or admin role can open this page.

Open the page#

  1. Open the back office. See Administration.
  2. In the Platform group, click Platform settings.
  3. Change the fields you need and click Save.

The changes take effect right away. Stacklane writes the audit event admin.platform.settings.

Brand#

FieldRequiredDescription
Product nameYesThe name of your service, up to 40 characters. Default: Stacklane.
Accent colorYesA hex color in the form #rrggbb, for example #0f766e. Default: #6366f1.
Support emailNoEmail address for support.
WebsiteNoThe address of your public website. Must start with http:// or https://.
Documentation URLNoLink to your customer documentation. Must start with http:// or https://.
Status page URLNoLink to your status page. Must start with http:// or https://.

Where the brand appears#

If you leave an optional field empty, the portal does not show the link or icon.

Sign-up and defaults#

FieldDefaultDescription
Default languageEnglishThe language of the portal before a user chooses one. You can choose English or Dutch.
Default time zoneEurope/AmsterdamThe time zone for users who sign up or are invited. Users can change it in their profile. Use a name from the time zone database, for example Europe/Berlin or America/New_York.
Allow new customers to sign upOnWhen this is off, the sign-up page shows "Registration is closed" and the API returns 403 with the code registration_closed.
Require a verified email address before using the portalOnWhen this is on, customers must click the link in the confirmation email before they can sign in.

Sign-up#

When sign-up is open, anyone can create an account on the sign-up page. Stacklane then:

  1. creates a new organization, named after the company name or, if that is empty, the person's name;
  2. makes the new user the administrator of that organization;
  3. sends a confirmation email with a link that is valid for 48 hours.

If someone signs up with an email address that already has an account, Stacklane does not create a second account. It sends an email to the existing address with a link to reset the password.

Verified email addresses#

When you require verified email addresses, a customer who has not clicked the confirmation link gets the message "Confirm your email address first" when they sign in. They can ask for a new link on the sign-in page.

This rule does not apply to:

Resetting a password through the email link also marks the address as confirmed.

Closed sign-up#

Close sign-up when you only want to create accounts yourself. You can then:

Settings in the API#

The page uses these endpoints. Both need the owner or admin staff role.

MethodPathDescription
GET/api/admin/platform/settingsRead the brand and access settings.
PUT/api/admin/platform/settingsReplace the brand and access settings.

Example body for PUT:

{
  "branding": {
    "product_name": "Example Cloud",
    "accent_color": "#0f766e",
    "support_email": "support@example.com",
    "docs_url": "https://docs.example.com",
    "status_url": "https://status.example.com",
    "website_url": "https://www.example.com"
  },
  "access": {
    "registration_open": true,
    "require_verified_email": true,
    "default_locale": "en",
    "default_timezone": "Europe/Amsterdam"
  }
}

The portal reads the public part of these settings, without signing in, from GET /api/iam/frontend/variables. That response contains the product name, accent color, support email, the three links, whether sign-up is open and the default language.