Site

Access global site settings. Available on all pages.

All Fields

Field	Arguments	Returns	Description
id	—	int	Site ID
name	—	string	Site name
title	—	string	Site title (alias)
blogname	—	string	Blog name (alias)
description	—	string	Site tagline
url	—	string	Site URL
link	—	string	Site URL (alias)
home_url	—	string	Home URL
site_url	—	string	WordPress URL
siteurl	—	string	WordPress URL (alias)
admin_email	—	string	Administrator email
language	—	string	Site language code
charset	—	string	Character set (UTF-8)
multisite	—	bool	Is multisite network
theme	—	object	Current theme object
icon	—	Image	Site icon
option	option_name	mixed	WordPress option value

Basic Fields

{{ site.name }}
{{ site.description }}

URLs

{{ site.url }}
{{ site.home_url }}
{{ site.site_url }}

Configuration

{{ site.admin_email }}
{{ site.language }}
{{ site.charset }}
{{ site.multisite }}

Theme

{{ site.theme.name }}
{{ site.theme.version }}

Site Icon

The icon field returns an Image object.

{{ site.icon.src }}
{{ site.icon.src('thumbnail') }}

Options

{{ site.option('blogname') }}
{{ site.option('posts_per_page') }}
{{ site.option('date_format') }}
{{ site.option('my_custom_option') }}
{{ site.option('theme_settings').colors.primary }}

Security: Options must be whitelisted via the unblock/data/allowed_options filter:

add_filter( 'unblock/data/allowed_options', function( $allowed ) {
    $allowed[] = 'my_custom_option';
    return $allowed;
});

Common Patterns

Site branding

{{ site.name }}
{{ site.description }}
{{ site.icon.src('thumbnail') }}

Footer copyright

© {{ post.date('Y') }} {{ site.name }}

Dynamic page title

{{ post.title }} - {{ site.name }}