Skip to main content

Changing the Background Image of Your Tenant

How to upload a custom background image to brand your Docupath tenant, including supported formats, recommended dimensions, and white-label considerations

Upload a custom background image to align Docupath with your organization's visual identity across the platform interface.


When to Use

  • Initial tenant setup

  • Company rebranding

  • White-label partner deployments


Prerequisites

  • Admin role in Docupath

  • Background image in JPG, JPEG, or PNG format


Steps

Step 1: Open System Settings

From the Main Menu, go to System Settings.

Step 2: Open Branding Customization

Find the Branding customization section on the page.

Step 3: Remove the Existing Background Image

Under Upload Background, delete the existing image.

Step 4: Upload Your New Image

Drag and drop your new background image into the upload area, or click to select a file.

Step 5: Follow Recommended Specifications

Format

Recommendation

JPG / JPEG

Supported; 1920 x 1080 px recommended

PNG

Supported; 1920 x 1080 px recommended

WEBP and other formats are not supported.

Step 6: Save

Click the Save button to apply the new background image.

Step 7: Verify the Update

If the background does not appear immediately, ask users to perform a hard refresh in their browser (cached images can delay updates).


Expected Outcome

The custom background image is displayed across the platform interface, visible to all users in the tenant.


Common Issues

Issue

Cause

Resolution

Background not updating after save

Browser cache

Perform a hard refresh (Ctrl+Shift+R or Cmd+Shift+R)

Image looks stretched or blurry

Incorrect dimensions or low resolution

Use a 1920 x 1080 px image in a supported format

Upload rejected

Unsupported file format (e.g., WEBP)

Convert the image to JPG, JPEG, or PNG before uploading


Notes

  • JPG, JPEG, and PNG are supported. WEBP and other formats are not supported.

  • 1920 x 1080 px is the recommended image size for clear rendering across screen sizes.

  • For white-label partner deployments, the custom background enables seamless visual integration under the partner's brand.

Did this answer your question?