Report Branding & Layout

Every report you export from Athena carries a letterhead — your organization's logo, name, and colors — plus a consistent header, footer, and page layout. These are set once, in a single Report Settings configuration, and applied to every report exported as HTML or printed to PDF. The settings are self-contained, so branded exports look the same on a fully air-gapped network as they do anywhere else.

Where to configure it#

Open Report Settings in the console at /settings/reports. The page is organized into four cards — Branding & logo, Header, Footer, and Page & format — with a Live preview alongside that updates as you edit. When you are happy with it, choose Save settings; Reset to defaults restores every field to its shipped value.

Editing Report Settings requires the Admin role. Any user with the Helpdesk role or above can read the current settings (the Reports pages need them to render), but only an Admin can change and save them. Changes are written to the audit log. See Roles & Permissions.

Branding & logo#

The letterhead shown at the top of every report:

Header#

Toggle what appears at the top of every report. All four are on by default:

Footer#

Controls the bottom of every page, including an optional confidentiality line:

Page & format#

Defaults for the print/PDF path and for the export dialog:

Paper size, orientation, margins, and the repeat-header option apply to the print / PDF output. Setting a Default export format only changes which option is pre-selected — you can still pick a different format at export time. See Exporting reports.

REST API#

The same configuration is available over the REST API at api/reports/settings. Reading requires Helpdesk or above; updating requires Admin.

PUT takes the full settings object. Send back every field (for example, the object you just fetched with GET) with your edits applied, so nothing is unintentionally reset. A validation failure — a bad hex color, an over-length text field, an oversized logo, or an out-of-range paper size / orientation / format / margin — returns 400 with the specific messages.

PUT /api/reports/settings
{
  "organizationName": "Contoso IT",
  "tagline": "Endpoint Operations",
  "accentColor": "#0f766e",
  "showDisclaimer": true,
  "disclaimerText": "Confidential — Contoso internal.",
  "paperSize": "Letter",
  "orientation": "Landscape",
  "defaultExportFormat": "HTML"
  // … plus the remaining fields from GET
}

PowerShell#

The Athena PowerShell module exposes the same settings through Get-AthenaReportSettings (Helpdesk or above) and Set-AthenaReportSettings (Admin). Unlike the raw PUT, Set-AthenaReportSettings applies only the parameters you pass and leaves every other field unchanged — so you can tweak one thing at a time.

# Read the current branding settings
Get-AthenaReportSettings

# Set the letterhead name and accent color (everything else is preserved)
Set-AthenaReportSettings -OrganizationName "Contoso IT" -AccentColor "#0f766e"

# Turn on the confidentiality disclaimer and set its text
Set-AthenaReportSettings -ShowDisclaimer $true `
    -DisclaimerText "Confidential — Contoso internal."

# Change the page and default-format settings
Set-AthenaReportSettings -PaperSize Letter -Orientation Landscape `
    -DefaultExportFormat HTML