{"id":31408,"date":"2018-04-21T15:47:46","date_gmt":"2018-04-21T15:47:46","guid":{"rendered":"https:\/\/ampscript.guide\/contentarea\/"},"modified":"2021-04-06T01:18:23","modified_gmt":"2021-04-06T01:18:23","slug":"contentarea","status":"publish","type":"post","link":"https:\/\/ampscript.guide\/contentarea\/","title":{"rendered":"ContentArea"},"content":{"rendered":"

ContentArea<\/h2>\n

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

Arguments<\/h3>\n

ContentArea(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 Area 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 the Content Area<\/td>\n<\/tr>\n
3<\/td>\nBoolean<\/td>\nFalse<\/td>\nReturn an error if the Content Area cannot be found<\/td>\n<\/tr>\n
4<\/td>\nString<\/td>\nFalse<\/td>\nDefault content to return if an error occurs from retrieving the Content Area 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 Area can be found in the Properties dialog accessible from the Content Area folder listing page.<\/p>\n

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

Example 1<\/h3>\n

A Content Area named LoyaltyGreeting<\/code> (ID: 11437<\/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 Area can be referenced as:<\/p>\n
%%[\n\nvar @contentAreaID\nset @contentAreaID = 11437 \/* my contents\\LoyaltyGreeting *\/\n\n]%%\n%%=ContentArea(@contentAreaID)=%%<\/code><\/pre>\n
Output<\/h4>\n
Hello, Curt!<\/code><\/pre>\n
Example 2<\/h3>\n
A Content Area named LoyaltyGreeting<\/code> (ID: 11437<\/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 the Content Area ID does not exist, fallback content is handled using the value of the fourth argument, or by conditionally showing content based on the value of the @retrieveStatus<\/code> variable.<\/p>\n
%%[\n\nvar @contentAreaID, @content, @retrieveStatus\nset @contentAreaID = 11434 \/* does not exist *\/\nset @content = ContentArea(@contentAreaID, \"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":"
ContentArea This function returns the content stored in the specified Content Area and optionally wraps the content in an Impression Region. Arguments ContentArea(1,2,3,4,5) Ordinal Type Required Description 1 Number True The ID of the Content Area 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 - ContentArea<\/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\/contentarea\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"The AMPscript Guide - ContentArea\" \/>\n<meta property=\"og:description\" content=\"ContentArea This function returns the content stored in the specified Content Area and optionally wraps the content in an Impression Region. Arguments ContentArea(1,2,3,4,5) Ordinal Type Required Description 1 Number True The ID of the Content Area 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\/contentarea\/\" \/>\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=\"2021-04-06T01:18:23+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\/contentarea\/#webpage\",\"url\":\"https:\/\/ampscript.guide\/contentarea\/\",\"name\":\"The AMPscript Guide - ContentArea\",\"isPartOf\":{\"@id\":\"https:\/\/ampscript.guide\/#website\"},\"datePublished\":\"2018-04-21T15:47:46+00:00\",\"dateModified\":\"2021-04-06T01:18:23+00:00\",\"author\":{\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\"},\"breadcrumb\":{\"@id\":\"https:\/\/ampscript.guide\/contentarea\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ampscript.guide\/contentarea\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ampscript.guide\/contentarea\/#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\/contentarea\/\",\"url\":\"https:\/\/ampscript.guide\/contentarea\/\",\"name\":\"ContentArea\"}}]},{\"@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\/31408"}],"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=31408"}],"version-history":[{"count":0,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31408\/revisions"}],"wp:attachment":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/media?parent=31408"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/categories?post=31408"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/tags?post=31408"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}