title — Set the title of the current axes or specified axes.

title attaches text to individual axes and returns a text handle for later property updates. Use sgtitle when one heading should span an entire figure.

Syntax

h = title(txt)
h = title(ax, txt)
h = title(txt, Name, Value, ...)
h = title(ax, txt, Name, Value, ...)

Inputs

Returns

Errors

How title works

• The returned value is a text handle that can be inspected or updated through get and set.
• With no explicit target, title attaches text to the current axes as returned by gca.
• Passing an axes handle as the first argument targets that specific axes, which is useful in subplot layouts.
• String scalars, char arrays, string arrays, cell arrays, and finite numeric scalars are accepted. Native integer scalars are formatted directly from their exact decimal value, including full-width int64 and uint64 values. String arrays and cell arrays produce multiline titles.
• Text styling properties — FontSize, FontWeight, FontAngle, Color, Interpreter, and Visible — use the shared plotting text-property system.
• FontSize accepts single, double, and all eight native integer classes, then validates that the size is positive, finite, and within the renderer's supported range.

Examples

Add a title to the current axes

plot(0:0.1:2*pi, sin(0:0.1:2*pi));
title('Sine Wave');

Expected output:

% title is rendered above the axes

Style the title and inspect its handle

plot(1:10, rand(1, 10));
h = title('Random Signal', 'FontSize', 16, 'FontWeight', 'bold');
get(h, 'Type')

Expected output:

ans =
    'text'

Set an independent title on each subplot panel

subplot(1, 2, 1);
plot(0:0.1:pi, sin(0:0.1:pi));
title('Sine');
subplot(1, 2, 2);
plot(0:0.1:pi, cos(0:0.1:pi));
title('Cosine');

Expected output:

% Each panel has its own title; the figure has none

Target a specific axes using an explicit handle

ax1 = subplot(1, 2, 1);
plot(ax1, 1:5, 1:5);
ax2 = subplot(1, 2, 2);
plot(ax2, 1:5, (1:5).^2);
title(ax1, 'Linear');
title(ax2, 'Quadratic');

Expected output:

% Titles are attached to their respective axes regardless of which is currently selected

Create a multiline title from a string array

plot(1:5, [2 4 1 3 5]);
title(["Top line"; "Bottom line"]);

Expected output:

% Both strings appear, stacked above the axes

Update a title after plotting using set

plot(1:10, rand(1, 10));
h = title('Draft');
set(h, 'String', 'Final Title', 'FontSize', 14);

Expected output:

% The axes title is updated in place

Using title with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how title changes the result.

FAQ

title({'First line', 'Second line'});

h = title('Initial');
set(h, 'String', 'Updated', 'Color', 'r');

ax = subplot(2, 1, 1);
title(ax, 'Top Panel');

Related Plotting functions

More plotting resources

• Styling plots and axes
• Plot replay and export
• Complete plotting guide

Open-source implementation

Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how title is executed, line by line, in Rust.

• View the source for title in Rust on GitHub
• Learn how the RunMat runtime works
• Found a bug? Open an issue with a minimal reproduction.

About RunMat

RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 license.

• RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
• Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.

Getting started · Benchmarks · Pricing