the_title( string $before = '', string $after = '', bool $echo = true )
Display or retrieve the current post title with optional markup.
Parameters
- $before
-
(string) (Optional) Markup to prepend to the title.
Default value: ''
- $after
-
(string) (Optional) Markup to append to the title.
Default value: ''
- $echo
-
(bool) (Optional) Whether to echo or return the title. Default true for echo.
Default value: true
Return
(void|string) Void if $echo argument is true, current post title if $echo is false.
More Information
This function displays or returns the unescaped title of the current post. This tag may only be used within The Loop, to get the title of a post outside of the loop use get_the_title. If the post is protected or private, this will be noted by the words “Protected: ” or “Private: ” prepended to the title.
Security considerations
Like the_content() , the output of the_title() is unescaped. This is considered a feature and not a bug, see the FAQ “Why are some users allowed to post unfiltered HTML?” . If the post title is <script>alert("test");</script>, then that JavaScript code will be run wherever the_title() is used. For this reason, do not write code that allows untrusted users to create post titles.
Source
File: wp-includes/post-template.php
function the_title( $before = '', $after = '', $echo = true ) {
$title = get_the_title();
if ( strlen( $title ) == 0 ) {
return;
}
$title = $before . $title . $after;
if ( $echo ) {
echo $title;
} else {
return $title;
}
}
Expand full source code Collapse full source code View on Trac View on GitHub
Changelog
| Version | Description |
|---|---|
| 0.71 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Example
This would print the title to the screen as an h3.
There are two ways to get the post/page title for WordPress.
`get_the_title();` and `the_title();`
**How to use `get_the_title();`**
“`php
“`
**How to use `the_title();`**
“`php
the_title(”, ”);
“`
**What is difference between `get_the_title();` and `the_title();`?**
`the_title();` ill echo its value, but `get_the_title();` does not echo (just returns the value).
This is the standard for WordPress functions: the functions that start with `the_` will echo what the corresponding function starting with `get_` returns. Other functions have a parameter to choose echo or not and others only return values.
Simple use case