{"id":31412,"date":"2018-04-21T15:47:46","date_gmt":"2018-04-21T15:47:46","guid":{"rendered":"https:\/\/ampscript.guide\/contentblockbyid\/"},"modified":"2025-06-02T13:20:04","modified_gmt":"2025-06-02T13:20:04","slug":"contentblockbyid","status":"publish","type":"post","link":"https:\/\/ampscript.guide\/contentblockbyid\/","title":{"rendered":"ContentBlockByID"},"content":{"rendered":"

ContentBlockByID<\/h2>\n

This function returns the content stored in the specified Content Block and optionally wraps the content in an Impression Region<\/a>.<\/p>\n

Arguments<\/h3>\n

ContentBlockByID(1,2,3,4,5)<\/code><\/p>\n\n\n\n\n\n\n\n\n\n
Ordinal<\/th>\nType<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>\nNumber<\/td>\nTrue<\/td>\nThe ID of the content block to return. This can be specified as a String or Number.<\/td>\n<\/tr>\n
2<\/td>\nString<\/td>\nFalse<\/td>\nName of the Impression Region<\/a> to associate with this Content Area<\/td>\n<\/tr>\n
3<\/td>\nBoolean<\/td>\nFalse<\/td>\nReturn an error if the content block cannot be found<\/td>\n<\/tr>\n
4<\/td>\nString<\/td>\nFalse<\/td>\nDefault content if an error occurs retrieving the content block specified in Ordinal 1<\/td>\n<\/tr>\n
5<\/td>\nNumber<\/td>\nFalse<\/td>\nNumeric status code resulting from the retrieve. A value of 0<\/code> indicates the retrieve was successful, while -1<\/code> indicates that the content was not found or empty<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

NOTE: The ID for the content block can be found in the Properties menu, accessible from the drop-down menu on the right-hand side of the Content Builder listing page.<\/p>\n

NOTE: This function is only for use with Content Builder assets. It does not<\/em> retrieve content stored in Classic Content. To retrieve content from Classic Content by ID, use the ContentAreaByID<\/a> function.<\/p>\n<\/blockquote>\n

Example 1<\/h3>\n

A Content Block named LoyaltyGreeting<\/code> (ID: 5794<\/code>) contains the following code:<\/p>\n

%%[\n\nvar @firstName\nset @firstName = properCase(AttributeValue(\"FirstName\"))\n\n]%%\nHello, %%=v(@firstName)=%%!<\/code><\/pre>\n
The Content Block can be referenced as:<\/p>\n
%%[\n\nvar @contentBlockID\nset @contentBlockID = 5794 \/* Content Builder\\LoyaltyGreeting *\/\n\n]%%\n%%=ContentBlockByID(@contentBlockID)=%%<\/code><\/pre>\n
Output<\/h4>\n
Hello, Curt!<\/code><\/pre>\n
Example 2<\/h3>\n
A Content Block named LoyaltyGreeting<\/code> (ID: 5794<\/code>) contains the following code:<\/p>\n
%%[\n\nvar @firstName\nset @firstName = properCase(AttributeValue(\"FirstName\"))\n\n]%%\nHello, %%=v(@firstName)=%%!<\/code><\/pre>\n
In the scenario where a Content Block ID does not exist, fallback content is handled with the value of the fourth argument or by conditionally showing content based on the value of the @retrieveStatus<\/code> variable:<\/p>\n
%%[\n\nvar @contentBlockID, @content, @retrieveStatus\nset @contentBlockID = 9794 \/* does not exist *\/\nset @content = ContentBlockByID(@contentBlockID, \"Greeting\", 0, \"Hello!\", @retrieveStatus)\n\noutput(concat(@content))\n\nif @retrieveStatus < 0 then\n  output(concat('<br><br><a href=\"https:\/\/limedash.com\/join\">Join Now<\/a> &raquo;'))\nendif\n\n]%%\n<\/code><\/pre>\n
Output<\/h4>\n
Hello!\n\n<a href=\"https:\/\/limedash.com\/join\">Join Now<\/a> &raquo;<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
ContentBlockByID This function returns the content stored in the specified Content Block and optionally wraps the content in an Impression Region. Arguments ContentBlockByID(1,2,3,4,5) Ordinal Type Required Description 1 Number True The ID of the content block to return. This can be specified as a String or Number. 2 String False Name of the Impression Region […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"yoast_head":"\nThe AMPscript Guide - ContentBlockByID<\/title>\n<meta name=\"robots\" content=\"index, follow\" \/>\n<meta name=\"googlebot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta name=\"bingbot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ampscript.guide\/contentblockbyid\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"The AMPscript Guide - ContentBlockByID\" \/>\n<meta property=\"og:description\" content=\"ContentBlockByID This function returns the content stored in the specified Content Block and optionally wraps the content in an Impression Region. Arguments ContentBlockByID(1,2,3,4,5) Ordinal Type Required Description 1 Number True The ID of the content block to return. This can be specified as a String or Number. 2 String False Name of the Impression Region […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ampscript.guide\/contentblockbyid\/\" \/>\n<meta property=\"og:site_name\" content=\"The AMPscript Guide\" \/>\n<meta property=\"article:published_time\" content=\"2018-04-21T15:47:46+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-06-02T13:20:04+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ampscript.guide\/#website\",\"url\":\"https:\/\/ampscript.guide\/\",\"name\":\"The AMPscript Guide\",\"description\":\"The Definitive Scripting Manual for Salesforce Marketing Cloud\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/ampscript.guide\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/contentblockbyid\/#webpage\",\"url\":\"https:\/\/ampscript.guide\/contentblockbyid\/\",\"name\":\"The AMPscript Guide - ContentBlockByID\",\"isPartOf\":{\"@id\":\"https:\/\/ampscript.guide\/#website\"},\"datePublished\":\"2018-04-21T15:47:46+00:00\",\"dateModified\":\"2025-06-02T13:20:04+00:00\",\"author\":{\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\"},\"breadcrumb\":{\"@id\":\"https:\/\/ampscript.guide\/contentblockbyid\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ampscript.guide\/contentblockbyid\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ampscript.guide\/contentblockbyid\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/\",\"url\":\"https:\/\/ampscript.guide\/\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"position\":2,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/contentblockbyid\/\",\"url\":\"https:\/\/ampscript.guide\/contentblockbyid\/\",\"name\":\"ContentBlockByID\"}}]},{\"@type\":[\"Person\"],\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\",\"name\":\"dev\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","_links":{"self":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31412"}],"collection":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/comments?post=31412"}],"version-history":[{"count":0,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31412\/revisions"}],"wp:attachment":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/media?parent=31412"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/categories?post=31412"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/tags?post=31412"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}