Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.penbox.io/llms.txt

Use this file to discover all available pages before exploring further.

The Branding page lets you configure the visual identity applied to your forms, email notifications, and the app. Access it from Settings → Branding.

Images

ImageWhere it appears
LogoTop of your forms and in email notifications sent to recipients.
IconInside the Penbox app (workspace switcher, navigation).
FaviconBrowser tab icon when recipients open a form.
Click any image to open the image editor. After selecting a file, a crop dialog opens — drag to reposition and scroll with your mouse wheel to resize the image within the crop frame. Click Pick to confirm.

Colors

Six colors can be customized to match your brand:
ColorUsed for
App barBackground of the top navigation bar in forms.
PrimaryMain accent color — buttons, active steps, progress indicators.
InfoInformational tags and callouts.
SuccessValidated and completed steps.
WarningMissing or incomplete steps.
ErrorErrors in steps or form elements.
A live preview of your logo and primary color is shown on the right side of the page.

Multiple brandings

If your plan supports it, you can create multiple branding profiles — useful when running forms under different brands or for different clients. Use the dropdown at the top to switch between profiles and the + button to add a new one. Each branding profile has its own images and colors and can be assigned independently to forms and templates. Apply a specific branding profile when someone opens a generic link by appending a query parameter to the URL. When you copy a generic link from Penbox, only the base URL is copied — the app does not add a branding parameter for you.
  1. Go to Templates and open the form template.
  2. Click Copy link on the generic link card.
The base URL looks like this:
https://{hostname}/f/{flow-customization-id}

Step 2: Find the branding slug

  1. Open Settings → Branding.
  2. If you have multiple profiles, select the one you want from the dropdown.
  3. Note the slug displayed next to the selector (for example, slug: partner-acme).
Do not use default as the slug — that label is for the primary workspace profile in the UI only. It is not a valid slug for URLs or the API.

Step 3: Append the branding parameter

Add branding[slug] to the generic link:
https://{hostname}/f/{flow-customization-id}?branding[slug]=partner-acme
When someone opens that URL, Penbox looks up the matching branding profile in the workspace and attaches it to the new form.

Default behavior

If you omit branding[slug], the form uses the workspace’s default branding — the primary profile configured under Settings → Branding.

Requirements

  • The slug must exist in the same workspace as the form template.
  • The slug must match exactly (lowercase, as shown in Settings → Branding).
  • If the slug does not match any profile in that workspace, the parameter is ignored and the workspace default branding is used.

Example

https://forms.acme.com/f/a1b2c3d4-e5f6-7890-abcd-ef1234567890?branding[slug]=partner-brand
That link creates a new anonymous form with the partner-brand profile applied to the form experience.
There is no UI option on the generic link copy button to pick a branding profile. Build the URL manually, or generate it with your own tooling or scripts.

Using branding via the Connect API

When creating forms programmatically, pass the branding slug in the request body instead of a URL parameter. See Create Form for details.