WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/bloginfo

Description

Displays information about your site, mostly gathered from the information you supply in your User Profile and General Settings WordPress Administration Screens. It can be used anywhere within a template file. This always prints a result to the browser. If you need the values for use in PHP, use get_bloginfo().

Usage

 <?php bloginfo$show ); ?> 

Parameters

$show
(string) (Optional) Keyword naming the information you want.
Default: name
  • 'name' - Displays the "Site Title" set in Settings > General. This data is retrieved from the "blogname" record in the wp_options table.
  • 'description' - Displays the "Tagline" set in Settings > General. This data is retrieved from the "blogdescription" record in the wp_options table.
  • 'wpurl' - Displays the "WordPress address (URL)" set in Settings > General. This data is retrieved from the "siteurl" record in the wp_options table. Consider echoing site_url() instead, especially for multi-site configurations using paths instead of subdomains (it will return the root site not the current sub-site).
  • 'url' - Displays the "Site address (URL)" set in Settings > General. This data is retrieved from the "home" record in the wp_options table. Consider echoing home_url() instead.
  • 'admin_email' - Displays the "E-mail address" set in Settings > General. This data is retrieved from the "admin_email" record in the wp_options table.
  • 'charset' - Displays the "Encoding for pages and feeds" set in Settings > Reading. This data is retrieved from the "blog_charset" record in the wp_options table. Note: In Version 3.5.0 and later, character encoding is no longer configurable from the Administration Panel. Therefore, this parameter always echoes "UTF-8", which is the default encoding of WordPress.
  • 'version' - Displays the WordPress Version you use. This data is retrieved from the $wp_version variable set in wp-includes/version.php.
  • 'html_type' - Displays the Content-Type of WordPress HTML pages (default: "text/html"). This data is retrieved from the "html_type" record in the wp_options table. Themes and plugins can override the default value using the pre_option_html_type filter.
  • 'text_direction' - Displays the Text Direction of WordPress HTML pages. Consider using is_rtl() instead.
  • 'language' - Displays the language of WordPress.
  • 'stylesheet_url' - Displays the primary CSS (usually style.css) file URL of the active theme. Consider echoing get_stylesheet_uri() instead.
  • 'stylesheet_directory' - Displays the stylesheet directory URL of the active theme. (Was a local path in earlier WordPress versions.) Consider echoing get_stylesheet_directory_uri() instead.
  • 'template_url' / 'template_directory' - URL of the active theme's directory ('template_directory' was a local path before 2.6; see get_theme_root() and get_template() for hackish alternatives.) Within child themes, both get_bloginfo('template_url') and get_template() will return the parent theme directory. Consider echoing get_template_directory_uri() instead (for the parent template directory) or get_stylesheet_directory_uri() (for the child template directory).
  • 'pingback_url' - Displays the Pingback XML-RPC file URL (xmlrpc.php).
  • 'atom_url' - Displays the Atom feed URL (/feed/atom).
  • 'rdf_url' - Displays the RDF/RSS 1.0 feed URL (/feed/rfd).
  • 'rss_url' - Displays the RSS 0.92 feed URL (/feed/rss).
  • 'rss2_url' - Displays the RSS 2.0 feed URL (/feed).
  • 'comments_atom_url' - Displays the comments Atom feed URL (/comments/feed).
  • 'comments_rss2_url' - Displays the comments RSS 2.0 feed URL (/comments/feed).
  • 'siteurl' - Deprecated since version 2.2. Echo home_url(), or use bloginfo('url').
  • 'home' - Deprecated since version 2.2. Echo home_url(), or use bloginfo('url').

Examples

Show Blog Title

Displays your blog's title in a <h1> tag.

<h1><?php bloginfo('name'); ?></h1>

Show Blog Title in Link

Displays your blog's title in a link.

<a href="<?php bloginfo('url'); ?>" title="<?php bloginfo('name'); ?>"><?php bloginfo('name'); ?></a>

Show Character Set

Displays the character set your blog is using (e.g. "utf-8").

NOTE: In version 3.5 and later, default character encoding is set to UTF-8 and is not configurable from the Administration Screen.

<p>Character set: <?php bloginfo('charset'); ?> </p>

Show Blog Description

Displays the tagline of your blog as set in Settings > General.

<p><?php bloginfo('description'); ?> </p>

Example output

From version 2.7, in case of host example.com, the Blog address (URL) is shown as http://www.example.com/home, and the WordPress address (URL) is installed on http://www.example.com/home/wp.

Please note that directory URLs are missing trailing slashes.

admin_email          = admin@example.com
atom_url             = http://www.example.com/home/feed/atom
charset              = UTF-8
comments_atom_url    = http://www.example.com/home/comments/feed/atom
comments_rss2_url    = http://www.example.com/home/comments/feed
description          = Just another WordPress blog
home                 = http://www.example.com/home (DEPRECATED! use url option instead)
html_type            = text/html
language             = en-US
name                 = Testpilot
pingback_url         = http://www.example.com/home/wp/xmlrpc.php
rdf_url              = http://www.example.com/home/feed/rdf
rss2_url             = http://www.example.com/home/feed
rss_url              = http://www.example.com/home/feed/rss
siteurl              = http://www.example.com/home (DEPRECATED! use url option instead)
stylesheet_directory = http://www.example.com/home/wp/wp-content/themes/largo
stylesheet_url       = http://www.example.com/home/wp/wp-content/themes/largo/style.css
template_directory   = http://www.example.com/home/wp/wp-content/themes/largo
template_url         = http://www.example.com/home/wp/wp-content/themes/largo
text_direction       = ltr
url                  = http://www.example.com/home
version              = 3.5
wpurl                = http://www.example.com/home/wp

Notes

Change Log

  • Since: 0.71

Source File

bloginfo() is located in wp-includes/general-template.php.

Related

Directory URL Tags

WordPress Directories:
home_url() Home URL http://www.example.com
site_url() Site directory URL http://www.example.com or http://www.example.com/wordpress
admin_url() Admin directory URL http://www.example.com/wp-admin
includes_url() Includes directory URL http://www.example.com/wp-includes
content_url() Content directory URL http://www.example.com/wp-content
plugins_url() Plugins directory URL http://www.example.com/wp-content/plugins
theme_url() Themes directory URL (#18302) http://www.example.com/wp-content/themes
wp_upload_dir() Upload directory URL (returns an array) http://www.example.com/wp-content/uploads
See also index of Function Reference and index of Template Tags.