How to Register Custom Styles in Bold Reports Server

Customizing the appearance of your reports improves the user experience and helps maintain brand consistency. By creating and uploading a custom styles JSON file, you can define tenant-specific styles that are independently managed and applied within Bold Reports Server.

Step-by-Step Instructions

Step 1: Upload the JSON File to Bold Reports Server

Click the [+] icon on the left side panel of the Bold Reports Server.
Select the Upload File option from the menu.
In the upload dialog, set the Name to custom_style. The system requires this exact name to recognize it as the default styles file.
Click the ellipsis (three dots) next to the File field to select your custom_style.json file, then click Save.

Sample custom styles JSON File structure

"table header": {
    "font-family": "arial",
    "font-size": "13.333333333333334px",
    "font-weight": "bold",
    "background-color": "#6495ED",
    "border-bottom-color": "navy",
    "border-right-color": "gray",
    "border-left-color": "gray",
    "border-right-width": "1.333px",
    "border-left-width": "1.333px",
    "border-top-width": "2px",
    "border-bottom-width": "2px",
    "border-bottom-style": "double",
    "border-top-color": "navy"
},
"header": {
    "background-color": "#6495ED",
    "font-family": "arial",
    "font-size": "0.16666979166666665in",
    "font-style": "normal",
    "font-weight": "bold",
    "color": "white"
}

Important Notes

Only one file named custom_style can exist. To update styles, re-upload the file with the same name.
Only the original uploader or an administrator can modify this file.
If no file is uploaded, the system falls back to shared or preconfigured styles.

Step 2: Apply Styles in the Web Designer

Open a report in the Bold Reports Web Designer and select the table or item you want to style.
Click the Properties icon to open the settings panel.
Navigate to the Miscellaneous section and choose your style from the Custom style property dropdown.

Step 3: Preview

Once applied, your table will reflect the custom branding defined in your JSON file.

You can download a Sample custom_styles.json to use as a template.