Skip to main content
Themes let you customize the appearance of your Evidence projects. You can set custom colors for charts and backgrounds, adjust page layouts, and preview changes before saving. theme-editor

​
What You Can Customize

​
Background Color

  • The base color for your pages and charts
  • All other UI colors (text, borders, etc.) are automatically derived for good contrast
  • Supports both light and dark modes

​
Chart Color Palette

  • Colors used for different series in your charts (bar charts, line charts, etc.)
  • Each series uses the next color in the palette
color-palette

​
Color Scale

Used in:
  • Tables with viz="color" on measures
  • Calendar heatmaps
  • Heatmap components
Single color: Automatically creates a gradient from your background to the color
  • Example: #eb00e3 (purple) → Gradient from background → purple
color-scale-single Multiple colors: Uses your exact colors to create a custom gradient
  • Example: #fdf2fc, #eb00e3 → Gradient from white → purple
color-scale-multi

​
Page Layout

Page Width
  • Article: Centered with limited width (better for reading)
  • Full: Uses the full browser width (better for dashboards)
Cards
  • Wrap each component with a border and a drop shadow
  • Creates a dashboard-style look
  • When enabled, you can customize:
    • Card Color: Background of individual components
    • Page Background: Color behind the cards
Table of Contents
  • Show/hide the table of contents sidebar
  • Automatically generated from your page headings
  • Not displayed in downloaded PDFs

​
Theme Hierarchy

Themes work in a hierarchy, with each level able to override the one above it: Organization → Project → Page → Component For each color or setting, you can choose:
  • Inherit/Default: Use the setting from the level above (shown in gray, read-only)
  • Custom: Set your own value using the color picker
The theme preview shows you exactly how your changes will look in both light and dark modes before you save.

​
Organization Theme

  • Sets the default theme for your entire organization
  • All projects inherit these settings unless they override them
  • Where to set: Settings → Theme

​
Project Theme

  • Customizes theme for a specific project
  • Overrides organization settings
  • All pages in the project inherit these unless they override them
  • Where to set: [Project Name] → Settings → Theme

​
Page Theme

  • Customizes theme for a single page
  • Overrides both organization and project settings
  • All components on the page inherit these unless they override them
  • Where to set: [Page Name] → Settings → Theme

​
Component Overrides

The most specific level - applies to a single chart or component and overrides all theme settings. Set directly in your markdown using component attributes. Example: 
{% combo_chart 
    data=sales 
    x=date 
    y=revenue 
    chart_options={
        color_palette: ['#ff0000', '#00ff00']
    }
/%}

​
Cards Mode

Enable cards in Page Layout settings to wrap each component in a visual container:

​
Without cards:

  • Components render directly on the page background
  • Clean, document-style appearance

​
Example

nocards

​
With cards:

  • Each component gets its own background
  • Page background shows behind the cards
  • Dashboard-style appearance
When cards are enabled, customize:
  • Card Color: Background color of the component containers
  • Page Background: Color visible behind the cards

​
Example

cards