---
title: "Perspective Themes"
id: "perspective-themes"
project: "MES User Manual"
url: "https://docs.sepasoft.com/articles/user-manual/perspective-themes"
updated: 2026-11-05T16:51:09Z
---

# Perspective Themes

**Sepasoft MES Module Suite**

## Perspective Theme

MES Perspective components use the Ignition Perspective theme on the session.

In **MES 4.83.2 SP0** and later, the Sepasoft theme is added to the page as an inline stylesheet. Do not import the Sepasoft CSS into your theme.

### Light and dark

The page looks for the first `<link rel="stylesheet">` whose address contains `theme`.
| Stylesheet address | Sepasoft stylesheet |
| --- | --- |
| Contains `dark` | Dark |
| Does not contain `dark` | Light |
| No stylesheet address contains `theme` | Light |
The `dark` check ignores letter case.

MES components also read the Perspective session theme name.
| Session theme name | Component palette |
| --- | --- |
| Starts with `dark` | Dark |
| Any other name | Light |
| No theme set | Light |
Name the theme so both checks select the same theme. Use `light`, `dark`, or a name that starts with `light-` or `dark-`. Examples: `light-cool`, `dark-cool`.

Set the theme on the Perspective session. In the Designer, the session property is `props.theme`.

### Custom theme

Create the theme in Ignition. Put `light` or `dark` at the start of the theme name. Add your own CSS in that theme.

Do not add an `@import` for the Sepasoft light or dark CSS. MES inserts that stylesheet.

### Override a Sepasoft style

Your theme CSS overrides a Sepasoft rule when your selector is more specific, or when the rule uses `!important`.

The Sepasoft theme sets CSS variables on the page. Set the same variable in your theme to change that color, font size, or spacing.

A component style property, such as `buttonStyle` or `tableStyle`, is written on that component. It overrides the theme for the properties you set. Those properties are documented on each component page.

#### CSS variables
| Variable | Sets |
| --- | --- |
| `--background` | Page background. MES components use this for the component background. |
| `--color` | Default text color |
| `--faintBackground` | Secondary background |
| `--altBackground` | Alternate background |
| `--errorColor` | Error text |
| `--buttonBackground`, `--buttonBorderColor`, `--buttonColor`, `--buttonFontSize` | Buttons |
| `--buttonHoverBackground`, `--buttonHoverBorderColor`, `--buttonHoverColor` | Button hover |
| `--buttonGroup1Background`, `--buttonGroup1Color`, `--buttonGroup1HoverBackground`, `--buttonGroup1HoverColor` | First button group |
| `--buttonGroup2Background`, `--buttonGroup2Color`, `--buttonGroup2HoverBackground`, `--buttonGroup2HoverColor` | Second button group |
| `--buttonGroup3Background`, `--buttonGroup3Color`, `--buttonGroup3HoverBackground`, `--buttonGroup3HoverColor` | Third button group |
| `--checkboxCheckedColor`, `--checkboxHoverBackground` | Checkboxes |
| `--inputBackground`, `--inputBorderColor`, `--inputBorderStyle`, `--inputBorderWidth`, `--inputColor`, `--inputFontSize`, `--inputBorderHoverColor` | Text inputs |
| `--inputLabelColor` | Input labels |
| `--inputDropDownBackground`, `--inputDropDownColor`, `--inputDropDownFontSize`, `--inputDropDownMaxHeight` | Dropdowns |
| `--inputDropDownHoverBackground`, `--inputDropDownHoverColor` | Dropdown hover |
| `--inputDropDownSelectedBackground`, `--inputDropDownSelectedColor` | Dropdown selection |
| `--dialogBackground`, `--dialogColor`, `--dialogFontSize` | Dialogs |
| `--dialogTitleBackground`, `--dialogTitleColor`, `--dialogTitleFontSize` | Dialog titles |
| `--dialogButtonBackground`, `--dialogButtonColor`, `--dialogButtonFontSize` | Dialog buttons |
| `--tableBackground`, `--tableBorderColor`, `--tableColor`, `--tableFontSize` | Tables |
| `--tableHeaderBackground`, `--tableHeaderColor`, `--tableHeaderFontSize` | Table headers |
| `--tableGridLineColor`, `--tableGridLineStyle`, `--tableGridLineSize` | Table grid lines |
| `--tableSelectedBackground`, `--tableSelectedRowColor` | Selected table row |
| `--toolbarBackground`, `--toolbarColor`, `--toolbarFontSize` | Toolbars |
| `--tooltipBackground`, `--tooltipColor`, `--tooltipFontSize` | Tooltips |
| `--treeBackground`, `--treeColor`, `--treeFontSize` | Trees |
| `--treeSelectedBackground`, `--treeSelectedBorderColor`, `--treeSelectedColor` | Selected tree node |
| `--listBackground`, `--listBorderColor`, `--listItemBackground`, `--listItemColor` | Lists |
| `--listItemSelectedBackground`, `--listItemSelectedColor` | Selected list item |
| `--timelineBackground`, `--timelineColor`, `--timelineHeaderBackground`, `--timelineHeaderColor` | Timelines |
Example. This sets the page background and the default text color in a theme whose name starts with `dark-`:

```python
:root {
  --background: #1a1a1a;
  --color: #f5f5f5;
}
```


Example. This sets the page background and the default text color in a theme whose name starts with `dark-`:

**Sepasoft MES Module Suite**