title — Set title text for the current axes or a specified axes handle with MATLAB-compatible title forms.

title attaches text labels to individual axes and returns a text handle for property updates. It follows MATLAB-compatible axes-scoped behavior, distinct from figure-level title helpers like sgtitle/suptitle.

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, and cell arrays are all accepted. String arrays and cell arrays produce multiline titles, with elements joined by newlines.
• Text styling properties — FontSize, FontWeight, FontAngle, Color, Interpreter, and Visible — use the shared plotting text-property system.
• Passing an unrecognized property name raises an error. Passing a non-numeric value for FontSize raises an error.

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