Customize Branding in WebReports – BridgeWorks Help Center

Trouble Viewing Images? Right-click on any image and select "Open in new tab" to view a larger version. You can also zoom in using Ctrl + Mouse Wheel for easier readability.

Article Goal

Learn how to configure the branding settings in WebReports to customize the platform's appearance, including logos, theme colors, and interface icons.

Why Customize Branding?

Branding allows you to align the look and feel of WebReports with your organization's identity. By updating logos, colors, and other visual elements, you can deliver a more professional and recognizable experience to your users.

Tip: Branding updates are especially useful for white-label implementations or when deploying WebReports across multiple departments or clients.

Where Can You Change Branding?

Branding settings are available on the Branding page under the Management tab in WebReports.

Important: If you plan to upload image files (e.g., logos, backgrounds), you must give the IIS_IUSRS account full control over the /assets/ directory. Without this permission, uploads will fail.

Available Branding Options

You can edit the following keys to update WebReports' appearance. All settings are located in the branding configuration section. A color picker tool may help with HEX value selection.

Primary Color

Controls the main accent color used throughout the UI.

Primary Focus Color / RGB

Used for hover/focus states and active elements.

"PrimaryFocusColor": "#cc741b"
"PrimaryFocusColorRGB": "#cc741b"

Note: It's recommended that both PrimaryFocusColor and PrimaryFocusColorRGB are set to the same HEX value. Avoid white or transparent colors, as these can make some interface elements unreadable.

Secondary Color

Typically used for sidebar and background themes.

"SecondaryColor": "#353f48"

Logo

Displays on the top-left of the WebReports interface.

"Logo": "/assets/logo.png"

Login Page Background

Background image shown on the login screen.

"LoginImage": "/assets/bglogin.webp"

Header Text

Text that appears in the page header (e.g., title bar).

"HeaderText": "WebReports"

Icons

Customize various interface icons.

"NotificationIcon": "/assets/notification.png"
"Favicon16": "/favicon-16x16.png"
"Favicon32": "/favicon-32x32.png"
"Favicon64": "/favicon-64x64.png"
"Favicon256": "/favicon-256x256.png"

Tip: Recommended icon dimensions are 192×192px to ensure proper rendering across browsers and devices.

Article Summary

WebReports supports a variety of branding options including color themes, logos, icons, and header text. All of these can be adjusted on the Branding page in the Management tab. With proper access permissions and image handling, you can quickly align the application to match your company’s visual identity.

Use Case: You’re rolling out WebReports for multiple clients. By customizing each client's instance with their own colors and logos, you create a seamless and familiar experience.