Agency branding & white-label reports
Set agency name, logo, brand colors and report footer at Settings → Team → Branding. Applies to Wevion reports. White-label plan, owner/admin only.
Written By Salvatore Sinigaglia
Last updated About 2 hours ago
Set agency name, logo, brand colors and report footer at Settings → Team → Branding. Applies to Wevion reports. White-label plan, owner/admin only.
Agency branding & white-label reports
Branding lets an agency put its own identity on Wevion reports: agency name, logo, primary and secondary colors, and a custom report footer. It lives at Settings → Team → Branding (
/settings/team/branding) and is available to super_admin, admin, and owner roles on a white-label plan. A live preview shows how the header and footer will look, and settings save with one button.
Who is this for
Agencies and resellers who send performance reports to clients and want those reports to carry the agency's brand instead of Wevion's. Requires a plan that includes white-label.
What you can set
Colors accept a 6-digit hex value and can be picked with the swatch or typed; an invalid hex is flagged inline and blocks saving until corrected. SVG logos are not accepted (raster formats only) and the file is validated by its actual content, not just its extension.
How to set your branding
Step 1: Open Branding
Go to Settings → Team → Branding. The page has three panels: Logo, Details (name, colors, footer), and a live Preview.
Step 2: Upload a logo
Click Upload logo and pick a JPG, PNG, or WebP file up to 2 MB. Wevion validates the file, stores it, and shows it in the preview header. Oversized or unsupported files are rejected with an error.
Step 3: Fill in the details
Enter your agency name, choose primary and secondary colors, and write a report footer. The Preview panel updates live so you can see the branded header and footer before saving.
Step 4: Save
Click Save. Backend calls PUT /api/v1/team-branding (logo upload uses POST /api/v1/team-branding/logo). Colors must be valid hex or the Save button stays disabled.
Plan gating
White-label branding is a plan entitlement. If your plan does not include it, the page opens in read-only mode: fields are disabled, the logo upload is blocked, and a banner steers you to upgrade on the billing page (/settings/team/billing). The backend also enforces the entitlement, so the branding cannot be changed via the API on a non-white-label plan.
Where branding appears
Branding is applied to Wevion reports. The agency name, logo, colors, and footer render on the report output so clients see your brand. The exact set of report surfaces depends on your report configuration — the values here are the single source your branded reports read from.
Roles and access
- Viewing and editing branding is limited to super_admin, admin, and owner in the app.
- The backend adds the same role guard before the plan check, so a member on a white-label plan without an owner/admin role cannot overwrite the agency branding.
FAQ
How do I white-label Wevion reports with my agency brand?
Open Settings → Team → Branding as a super_admin, admin, or owner on a white-label plan. Upload a logo (JPG/PNG/WebP, max 2 MB), set your agency name, choose primary and secondary hex colors, and add a report footer. The live preview shows the branded header and footer; click Save to apply. Wevion then renders your brand on reports instead of its own.
What logo formats and sizes does Wevion accept?
Wevion accepts raster logos in JPG, PNG, or WebP up to 2 MB. SVG is not allowed because it can embed scripts, so vector files must be exported to a raster format first. The upload is validated by the file's actual content, not just its extension, and oversized or unrecognized files are rejected with an inline error.
Why is the branding page read-only for me?
The Branding page is read-only when your plan does not include white-label. In that case Wevion disables the fields and logo upload and shows an upgrade banner linking to billing. It can also be read-only if you lack the required role — only super_admin, admin, and owner can edit branding, and the backend enforces both the role and the plan entitlement.
Which colors can I use for my brand?
Primary and secondary colors accept a 6-digit hexadecimal value (for example #1A73E8). You can pick a color with the swatch or type the hex directly; the primary color drives the report header background and the secondary color accents the body. An invalid hex is flagged inline and prevents saving until you fix it.
Steps
- Go to Settings → Team → Branding. The page has three panels: Logo, Details (name, colors, footer), and a live Preview.
- Click Upload logo and pick a JPG, PNG, or WebP file up to 2 MB. Wevion validates the file, stores it, and shows it in the preview header. Oversized or unsupported files are rejected with an error.
- Enter your agency name, choose primary and secondary colors, and write a report footer. The Preview panel updates live so you can see the branded header and footer before saving.
- Click Save. Backend calls PUT /api/v1/team-branding (logo upload uses POST /api/v1/team-branding/logo). Colors must be valid hex or the Save button stays disabled.
Last updated: 2026-07-02