Branding¶
Branding lets you align ValuePact with your organization's visual identity. You can customize the logo, color palette, custom domain, and email templates.
Who this is for¶
Admin Content Admin
Prerequisites¶
- Tenant Admin or Content Admin role
- Logo file in PNG or SVG format
- Access to your organization's DNS settings for custom domain setup
Logo¶
- Go to Admin > Configuration > Branding.
- Under Logo, click Upload.
- Select a PNG or SVG file.
- Preview the logo in the header and email template.
- Click Save.
Limit Maximum file size is 2 MB. Recommended dimensions: 200x40 pixels.
Colors¶
You can customize the primary and accent colors used in the UI.
- Open Configuration > Branding.
- Under Colors, click the color swatch next to Primary.
- Enter a HEX code or use the color picker.
- Repeat for Accent.
- Click Save.
The preview updates in real time. Changes apply on the next page load for all users.
Custom domain¶
A custom domain lets users access ValuePact from a URL such as value.yourcompany.com.
Step-by-step: configure a custom domain¶
- Go to Configuration > Branding > Custom Domain.
- Enter your domain name.
- Copy the DNS records displayed (CNAME and TXT for verification).
- Add the records to your DNS provider.
- Click Verify DNS.
- Once verified, enable Force HTTPS.
DNS propagation
DNS changes can take up to 24 hours. Do not delete the verification record after setup.
Email templates¶
Email templates control the look of invitations, notifications, and digests.
- Go to Configuration > Branding > Email Templates.
- Select a template: Invite, Notification, or Digest.
- Edit the subject line and body text.
- Use available variables such as
{{user_name}}and{{tenant_name}}. - Click Preview to send a test email.
- Click Save.
Permissions required¶
| Role | Permission | Scope |
|---|---|---|
| Super Admin | Manage all branding settings | Organization |
| Tenant Admin | Manage all branding settings | Organization |
| Content Admin | Manage logo, colors, and email templates | Organization |
| Analyst | View branded UI | Organization |
| Viewer | View branded UI | Organization |
Limits and guardrails¶
Limit Only one custom domain per tenant.
Limit Email template subject lines cannot exceed 200 characters.
Limit Color contrast is validated for accessibility. Low-contrast combinations are rejected.
Troubleshooting¶
Issue: logo appears blurry
Cause: The uploaded file is too small or in a raster format scaled beyond its resolution. Resolution: Upload an SVG for crisp rendering at all sizes. If using PNG, ensure it is at least 400x80 pixels.
Issue: custom domain shows a certificate error
Cause: HTTPS was enabled before DNS fully propagated, or the CNAME is incorrect. Resolution: Verify the CNAME record points to the correct target. Wait for DNS propagation, then toggle HTTPS off and on.
Issue: email template variables not rendering
Cause: A variable name is misspelled or unsupported for the selected template. Resolution: Use only the variables listed in the template sidebar. Variable names are case-sensitive.
Related pages¶
Escalation path¶
For branding issues affecting user trust or access:
- Revert to the default logo and colors from Branding > Reset Defaults.
- If the custom domain is broken, temporarily use the default domain.
- File a support ticket with screenshots and domain details.
- Escalate to
#valuepact-opsif HTTPS or domain verification fails repeatedly.