Posts

data:view

view. archive object Fields relating to the archive for the current view.
view. description string Description of the current view.
view. featuredImage image Featured image for the current view.
view. isArchive boolean Whether the current view is an Archive feed.
view. isError boolean True if the current view is an error page.
view. isHomepage boolean True if the current view is the homepage of the blog.
view. isLayoutMode boolean True if the view is the Layout mode for rearranging widgets in the template.
view. isMultipleItems boolean True if the current view has multiple posts, e.g. the homepage or a search page.
view. isPage boolean True if the current view is for a single page item.
view. isPage boolean True if the current view is a page item.
view. isPost boolean True if the current view is for a single post.
view. isPost boolean True if the current view is a post page.
view. isPreview boolean Whether the current view is a preview.
view. isPreview boolean True if the current view is a preview.
view. isSearch boolean True if the current view is for a query or label filter search.
view. isSingleItem boolean True if the current view is a single post or page.
view. pageId number Id of the page in the current view, if the view is a page item.
view. postId number Id of the post for the current view, if the current view is a post.
view. search object Data related to the search parameters of the current view.
view. title string Title of the current view.
view. type string Type of the current view, either "item" or "feed".
view. url url The url of the current view.
view.archive. day number Day of the current archive feed view, e.g. 15.
view.archive. month number Month of the current archive feed view, e.g. 4
view.archive. rangeMessage string Message describing the current archive view's date range.
view.archive. year number Year of the current archive view, e.g. 2016
view.search. label string Label filter for the current view's search.
view.search. query string Query filter for the current view's search.
view.search. resultsMessage string Localized message about the search results being shown.
view.search. resultsMessageHtml string HTML version of  resultsMessage .

data:blog

blog. adultContent boolean Whether the blog is contains adult content.
blog. blogId string Id of the blog.
blog. homepageUrl url Homepage url of the Blog.
blog. isPrivate boolean True if the blog is configured to be private, with a reader whitelist.
blog. languageDirection string The direction of the language used by the blog, either RTL or LTR.
blog. locale locale Locale code of the blog, representing the language that the blog will render its messages in.
blog. searchUrl url Url for executing a search for the blog.
blog. title string Title of the Blog.

data:skin

skin. vars array Variables of the skin rendered for the current view, if the current view is a post.

data:messages

messages. adsGoHere message "Ads go here", translated into the language used by the blog.
messages. archive message "Archive", translated into the language used by the blog.
messages. comments message "Comments" translated into the language used by the blog.
messages. edit message "Edit" translated into the language used by the blog.
messages. emailAddress message "Email address" translated into the language used by the blog.
messages. getEmailNotifications message "Get email notifications" translated into the language used by the blog.
messages. gotIt message "Got it" translated into the language used by the blog.
messages. hidden message "Hidden" translated into the language used by the blog.
messages. home message "Home" translated into the language used by the blog.
messages. image message "Image" translated into the language used by the blog.
messages. joinTheConversation message "Join the conversation" translated into the language used by the blog.
messages. keepReading message "Keep reading" translated into the language used by the blog.
messages. labels message "Labels" translated into the language used by the blog.
messages. latestPosts message "Latest posts" translated into the language used by the blog.
messages. learnMore message "Learn more" translated into the language used by the blog.
messages. loadMorePosts message "Load more posts" translated into the language used by the blog.
messages. myFavoriteSites message "My favorite sites" translated into the language used by the blog.
messages. myPhoto message "My photo" translated into the language used by the blog.
messages. newer message "Newer" translated into the language used by the blog.
messages. newerPosts message "Newer posts" translated into the language used by the blog.
messages. newest message "Newest" translated into the language used by the blog.
messages. noResultsFound message "No results found" translated into the language used by the blog.
messages. noTitle message "No title" translated into the language used by the blog.
messages. numberOfComments message "[Number] comments", where number is a parameter passed in, translated into the language used by the blog.

data:widgets

widgets. AdSense array An array of all of the AdSense widgets which are visible in the current page.
widgets. Attribution array An array of all of the Attribution widgets which are visible in the current page.
widgets. Blog array An array of all of the Blog widgets which are visible in the current page.
widgets. BlogArchive array An array of all of the BlogArchive widgets which are visible in the current page.
widgets. BlogList array An array of all of the BlogList widgets which are visible in the current page.
widgets. BlogSearch array An array of all of the BlogSearch widgets which are visible in the current page.
widgets. BloggerButton array An array of all of the BloggerButton widgets which are visible in the current page.
widgets. ContactForm array An array of all of the ContactForm widgets which are visible in the current page.
widgets. CustomSearch array An array of all of the CustomSearch widgets which are visible in the current page.
widgets. FeaturedPost array An array of all of the FeaturedPost widgets which are visible in the current page.
widgets. Feed array An array of all of the Feed widgets which are visible in the current page.
widgets. FollowByEmail array An array of all of the FollowByEmail widgets which are visible in the current page.
widgets. Followers array An array of all of the Followers widgets which are visible in the current page.
widgets. Gadget array An array of all of the Gadget (third-party) widgets which are visible in the current page.
widgets. HTML array An array of all of the HTML widgets which are visible in the current page.
widgets. Header array An array of all of the Header widgets which are visible in the current page.
widgets. Image array An array of all of the Image widgets which are visible in the current page.
widgets. Label array An array of all of the Label widgets which are visible in the current page.
widgets. LinkList array An array of all of the LinkList widgets which are visible in the current page.
widgets. Navbar array An array of all of the Navbar widgets which are visible in the current page.
widgets. PageList array An array of all of the PageList widgets which are visible in the current page.
widgets. PlusBadge array An array of all of the PlusBadge widgets which are visible in the current page.
widgets. PlusFollowers array An array of all of the PlusFollowers widgets which are visible in the current page.
widgets. PlusOne array An array of all of the PlusOne widgets which are visible in the current page.
widgets. Poll array An array of all of the Poll widgets which are visible in the current page.
widgets. PopularPosts array An array of all of the PopularPosts widgets which are visible in the current page.
widgets. Profile array An array of all of the Profile widgets which are visible in the current page.
widgets. ReportAbuse array An array of all of the ReportAbuse widgets which are visible in the current page.
widgets. Slideshow array An array of all of the Slideshow widgets which are visible in the current page.
widgets. Stats array An array of all of the Stats widgets which are visible in the current page.
widgets. Subscribe array An array of all of the Subscribe widgets which are visible in the current page.
widgets. Text array An array of all of the Text widgets which are visible in the current page.
widgets. TextList array An array of all of the TextList widgets which are visible in the current page.
widgets. Translate array An array of all of the Translate widgets which are visible in the current page.

Blog Posts gadget

blogComment message Message for commenting action on the blog.
description string The description for the blog.
feedLinks array An array of links to the blog's feeds.
feedLinks[i]. feedType string The feed's type, e.g. "Atom".
feedLinks[i]. mimeType string Mime type of the feed, e.g. "application/atom+xml".
feedLinks[i]. name string The name of the feed, e.g. "Posts".
feedLinks[i]. url string URL of the feed link.
footerBylines array An array of the 3 footer bylines, shown after a post.
footerBylines[i]. items array The byline items in the byline region.
footerBylines[i].items[i]. label string Label of the byline, shown before the byline content, e.g. "Posted by" for author.
footerBylines[i].items[i]. name string Name of the byline.
footerBylines[i]. regionName string Name of the footer byline region, e.g. "footer-2". There are 3 byline footer regions, but only one byline header region.
id string The id of the blog. Equivalent to data:blog.blogId.
messages object Object containing Blog Posts messages.
numPosts number Number of posts in the posts array. (Deprecated - can be found using the posts.size  equivalent).
olderPageUrl url URL of the next page of (older) posts, used for pagination.
posts array An array of the Blog's posts to be displayed in the current view.
posts[i]. allowComments boolean Whether the post has been configured to allow comments.
posts[i]. allowNewComments boolean Whether new comments are allowed to be made on the post.
posts[i]. author object Object containing fields relating to the author of the post.
posts[i].author. aboutMe string Contents of the 'About me' blurb on the post author's profile.
posts[i].author. name string Name of the author.
posts[i].author. profileUrl string URL of the profile of the post author.
posts[i]. body string The HTML content of the post.
posts[i]. commentFormIframeSrc string URL for the source of the comment iframe.
posts[i]. commentsUrl url URL linking to the comments on the post.
posts[i]. date date Date of the post.
posts[i]. emailPostUrl string URL for the Email post  byline's share-by-email action.
posts[i]. embedCommentForm boolean Whether the user has configured comments to be embedded in the page.
posts[i]. featuredImage image The featured image for the post.
posts[i]. hasJumpLink boolean Whether the post has a <!--more--> jump-break in it.
posts[i]. id string The ID of the post.
posts[i]. lastUpdated date Date that the post was last updated.
posts[i]. numberOfComments number The number of comments that have been made on the post.
posts[i]. reactionsUrl url URL for the iframe of the reactions byline of the post.
posts[i]. title string Title of the post.
posts[i]. url url URL of the post.
title string Title of the blog. Equivalent to the global data:blog.title field.

Header gadget

backgroundPositionStyleStr string Position style ("left" or "right"), depending on whether the blog is RTL.
description string Description of the blog.
image image Background image for the Header gadget, if there is one.
imagePlacement string Placement of the background image, if present. One of BEHIND, REPLACE, BEFORE_DESCRIPTION.
title string Title of the blog.

Popular Posts gadget

postDisplay object Object containing the display settings for a post.
postDisplay. showFeaturedImage boolean Whether to show the featured image for the post.
postDisplay. showSnippet boolean Whether to show a snippet of the post body.
postDisplay. showTitle boolean Whether to show the title of the post.
posts array Array of objects containing the popular posts.
posts[i]. body string HTML of the content of the post.
posts[i]. commentsUrl url URL of the comments of the post.
posts[i]. date date Date that the post was written.
posts[i]. featuredImage image Featured image for the post.
posts[i]. id string The ID of the post.
posts[i]. lastUpdated date Date that the post was last updated.
posts[i]. numberOfComments number The number of comments on the post.
posts[i]. title string Title of the post.
posts[i]. url url URL of the post.

Blog Archive gadget

data array Array containing objects which span the archive ranges.
data[i]. name string Name of the archive range, e.g. "July 2017".
data[i]. post-count number Number of posts in the archive range.
data[i]. url url URL for the archive range.
style string Style that the archive is rendered in - either FLAT, HIERARCHY or MENU.
title string Title of the Blog Archive gadget.

Labels gadget

display string Display style for the Labels gadget - either "list" or "cloud".
labels array Array containing objects for each of the labels.
labels[i]. count number Number of posts with the label.
labels[i]. name string Name of the label.
labels[i]. url url URL for viewing posts with the label (label search).
showFreqNumbers boolean Whether to show the number of posts with the label.
title string Title of the Labels gadget.

Featured Post gadget

postDisplay object Object containing the post display settings for the Featured Post gadget.
postDisplay. showFeaturedImage boolean Whether to show the featured image of the post.
postDisplay. showSnippet boolean Whether to show a snippet of the post body.
postDisplay. showTitle boolean Whether to show the title of the post.
posts array Array containing objects for the posts.
posts[i].author. featuredImage image Featured image for the post.
posts[i]. body string HTML content of the post's body.
posts[i]. commentsUrl url URL for the comments on the post.
posts[i]. date date Date that the post was written.
posts[i]. hasJumpLink boolean Whether the post contains the <!--more--> jump-link text.
posts[i]. id string ID of the post.
posts[i]. lastUpdated date Date that the post was last updated.
posts[i]. numberOfComments number Number of comments on the post.
posts[i]. title string Title of the post.
posts[i]. url url URL of the post.

Plus One gadget

annotation string Annotation of the Plus One gadget - either "bubble", "inline" or "none".
language string Language to display the Plus One gadget in.
size string Size of the Plus One gadget - either "small", "medium", "standard" or "tall".

Plus Followers gadget

height number Height of the Plus Followers display.
language string Language of the Plus Followers display.
profileUrl string URL of the Google+ profile, if the Plus Followers gadget is linked to one.
theme string Theme of the Plus Followers display - either DARK or LIGHT.
title string Title of the Plus Followers gadget.
widgetInstanceId string Instance ID of the Plus Followers gadget.
width number Width of the Plus Followers display.

Blogger Button gadget

source string Image source of the Blogger button to be shown.

Translate gadget

layout string Layout of the Translate gadget - either VERTICAL, HORIZONTAL or SIMPLE.
pageLanguage string Language of the page, e.g. "en" or "fr". Defaults to "auto" when no language is found.
title string Title of the Translate gadget.

Blog List gadget

items array Array of objects representing each of the blogs.
items[i]. blogIconUrl string Source URL for the icon of the blog.
items[i]. blogTitle string Title of the blog.
items[i]. blogUrl string The blog's homepage URL.
items[i]. itemSnippet string Snippet of the post's content for the first post of the blog.
items[i]. itemThumbnail object Object containing details for the thumbnail of the first post for the blog.
items[i].itemThumbnail. height number Height of the thumbnail of the first post for the blog.
items[i].itemThumbnail. url string URL of the thumbnail of the first post for the blog.
items[i].itemThumbnail. width number Width of the thumbnail of the first post for the blog.
items[i]. itemTitle string Title of the first post for the blog.
items[i]. itemUrl string URL of the first post for the blog.
items[i]. timePeriodSinceLastUpdate string Translated message representing the amount of time since the most recent update to the blog.
numItemsToShow number The number of items to show in the Blog List.
showIcon boolean Whether to show each blog's icon.
showItemSnippet boolean Whether to show a snippet of the first item for each blog.
showItemThumbnail boolean Whether to show a thumbnail with the first item of each blog.
showItemTitle boolean Whether to show the title of the first post for each blog.
sortType string Type of sorting used by the Blog List gadget - either ALPHABETICAL or LAST_UPDATE_DESCENDING.
totalItems number Total number of items in the items  array.

Contact gadget

blogId string ID of the blog.
submitUrl string URL for submitting the Contact form.
title string Title of the Contact Form gadget.