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

Contents

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.