theme

Set or get graphics theme

Since R2025a

Syntax

theme(newtheme)

theme(fig,newtheme)

gt = theme(___)

gt = theme

gt = theme(fig)

Description

Set Theme

theme(newtheme) sets the theme of the current figure to the specified new theme, which can be "light", "dark", "auto", or a GraphicsTheme object. Parentheses are optional for this syntax when you specify one of the theme names. For example, theme light is the same as theme("light").

Calling this function sets the Theme and ThemeMode properties of the figure.

theme(fig,newtheme) sets the theme of the specified figure.

gt = theme(___) sets the theme and returns it as a GraphicsTheme object.

Get Theme

gt = theme returns the theme of the current figure as a GraphicsTheme object.

gt = theme(fig) returns the theme of the specified figure.

Examples

Set Figure Theme

Create a figure and set its theme to "dark" by calling the theme function and returning the GraphicsTheme object as gt. Then create a bar chart in the figure.

fig = figure;
gt = theme(fig,"dark");
bar([1 2 3 4; 5 6 7 8])

Change the theme to "light".

theme(fig,"light")

Use the GraphicsTheme object, gt, to set the theme.

theme(fig,gt)

Input Arguments

newtheme — New theme

"light" | "dark" | "auto" | GraphicsTheme object

New theme, specified as "light", "dark", "auto", or a GraphicsTheme object.

fig — Target figure

Figure object | array of Figure objects

Target figure, specified as a Figure object or an array of Figure objects.

Output Arguments

gt — Graphics theme object

GraphicsTheme object

Graphics theme object with these properties.

Property	Description
Name	Short description of the theme, returned as 'Light Theme' or 'Dark Theme'.
BaseColorStyle	Basic color style of the theme, returned as 'light' or 'dark'. This property indicates the overall lightness or darkness of the theme. Query this property when deciding on a color palette for your chart or when writing a ThemeChangedFcn callback.

Version History

Introduced in R2025a