---
title: "Remote Support Branding"
slug: "new-custom-branding"
description: "Customize your ScreenMeet Remote Support client with unique branding options like app name, logo, and colors for a personalized user experience."
updated: 2026-06-08T14:32:26Z
published: 2026-06-08T14:32:26Z
canonical: "docs.screenmeet.com/new-custom-branding"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.screenmeet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remote Support Branding

Remote Support Branding allows administrators to customize the appearance of the ScreenMeet Remote Support client, including the application name, download file name, icon, logo, and color scheme. This feature applies to the new Remote Support client on both macOS and Windows.

Feature Enablement Required

Remote Support Branding must be enabled for your organization before it can be configured. Contact ScreenMeet Support to request access.

---

### Prerequisites

- Remote Support Branding enabled by ScreenMeet Support for your organization
- Administrator access to [console.screenmeet.com](https://console.screenmeet.com)
- New Remote Support client (macOS and Windows)

---

### Configuring Remote Support Branding

1. Log in to [console.screenmeet.com](https://console.screenmeet.com) as an administrator.
2. Navigate to **Organization** > **Settings & Policies** > **Remote Support Branding**.
3. Configure your settings:
  - **App Name:** The name of the application displayed in the client.
  - **Download File Name:** The name displayed as the downloaded file name.
    - Applies to the EXE installer only. Not applicable to the MSI.
  - **App Icon File:** The icon displayed in the title bar, taskbar, system tray, and installer.
    - Applies to Windows devices only.
    - Applies to the EXE installer only. Not applicable to the MSI.
  - **Customize Logo and Colors:**
    - Enter your hex color code for the Brand and Accent colors. Click anywhere on the screen after entering a code to preview the result before saving.
    - **Change Logo:** Customizes the logo displayed in the Remote Support client. Maximum file size is 6.5 kB.
4. Click **Save Branding** to apply your changes.
5. To revert all settings to the original defaults, click **Reset to Defaults**.

---

### Pre-Staging Branding for MDM Deployment

By default, the Remote Support client applies your organization's configured branding when it connects to its first session. At that point, the values from your console configuration are written to a local file named `cache.json`, located at `C:\ProgramData\Projector Inc\ScreenMeet Support`. If your deployment requires branding to be in place before any session is initiated, you can pre-stage this file by running the example PowerShell script below during the MDM deployment process.

When to Use This Approach

Pre-staging is optional. It is only necessary if your organization requires branding to be applied immediately upon installation, before the client connects to a session, to avoid end-user concerns about a non-branded app on their first ScreenMeet launch.

If this is not a concern, the default behavior will apply branding automatically on first use and be used for all sessions moving forward.

#### Prepare the PowerShell Script

The script below creates `cache.json` at the correct path, creates the directory if it does not exist, and logs activity to both `C:\ProgramData\ScreenMeet\Logs\cache-deploy.log` and the Windows Application Event Log under the source `ScreenMeet-Deploy`.

Update Branding Values Before Deploying

Replace the placeholder values for `app_name`, `BrandColor`, `AccentColor`, and the two `value` fields in the `colors` array with your organization's actual values from your Remote Support Branding configuration before deploying the script.

```powershell
#Requires -Version 5.1
$ErrorActionPreference = 'Stop'

# Output path - do not modify unless your ScreenMeet installation uses a non-default location
$OutputPath  = "C:\ProgramData\Projector Inc\ScreenMeet Support"
$OutputFile  = Join-Path $OutputPath "cache.json"
$LogFile     = Join-Path $env:ProgramData "ScreenMeet\Logs\cache-deploy.log"
$EventSource = "ScreenMeet-Deploy"

function Write-Log {
    param(
        [string]$Message,
        [ValidateSet("INFO","WARN","ERROR")]
        [string]$Level = "INFO"
    )
    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
    $entry = "[$timestamp][$Level] $Message"
    try {
        $logDir = Split-Path $LogFile
        if (-not (Test-Path $logDir)) { New-Item -ItemType Directory -Path $logDir -Force | Out-Null }
        Add-Content -Path $LogFile -Value $entry -Encoding UTF8
    } catch { }
    try {
        if (-not [System.Diagnostics.EventLog]::SourceExists($EventSource)) {
            [System.Diagnostics.EventLog]::CreateEventSource($EventSource, "Application")
        }
        $entryType = switch ($Level) {
            "ERROR" { [System.Diagnostics.EventLogEntryType]::Error }
            "WARN"  { [System.Diagnostics.EventLogEntryType]::Warning }
            default { [System.Diagnostics.EventLogEntryType]::Information }
        }
        Write-EventLog -LogName Application -Source $EventSource -EntryType $entryType -EventId 1000 -Message $Message
    } catch { }
    Write-Host $entry
}

# Replace placeholder values with your organization's Remote Support Branding configuration
$cacheJson = @'
{
  "app_name": "Your Organization - ScreenMeet",
  "download_file_name": "ScreenMeet.Support",
  "branding_data": {
    "colorFunction": "SupportNativeClientColorCalculator",
    "samplePage": "native-client-branding.html",
    "isOnlyUsingCoreColors": true,
    "colors": [
      {
        "name": "brand",
        "label": "Brand",
        "value": "#000000",
        "isCoreColor": true
      },
      {
        "name": "accent",
        "label": "Accent",
        "value": "#000000",
        "isCoreColor": true
      }
    ],
    "BrandColor": "#000000",
    "AccentColor": "#000000"
  }
}
'@

Write-Log "ScreenMeet cache.json deployment started. Target: $OutputFile"

try {
    if (-not (Test-Path $OutputPath)) {
        New-Item -ItemType Directory -Path $OutputPath -Force | Out-Null
        Write-Log "Created output directory: $OutputPath"
    }

    $utf8NoBom = New-Object System.Text.UTF8Encoding $false
    [System.IO.File]::WriteAllText($OutputFile, $cacheJson, $utf8NoBom)
    Write-Log "cache.json written successfully."
    exit 0

} catch {
    Write-Log "Deployment failed: $_" -Level "ERROR"
    exit 1
}
```

#### Verification

1. On a target endpoint, navigate to `C:\ProgramData\Projector Inc\ScreenMeet Support` and confirm `cache.json` is present.
2. Open `cache.json` in a text editor and verify the `app_name`, `BrandColor`, and `AccentColor` values match your branding configuration.
3. Review the deployment log at `C:\ProgramData\ScreenMeet\Logs\cache-deploy.log` for a successful write entry.
4. In Event Viewer, navigate to **Windows Logs > Application** and filter by source `ScreenMeet-Deploy` to confirm the script completed without errors.

---