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

ExecuteFilter<\/h2>\n

This function executes the specified Data Extension Data Filter and returns a row set.<\/p>\n

Argument<\/h3>\n

ExecuteFilter(1)<\/code><\/p>\n\n\n\n\n\n
Ordinal<\/th>\nType<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>\nString<\/td>\nTrue<\/td>\nCustomer\/External Key of the Data Filter to execute<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

NOTE: This function only works in a landing page, microsite page or CloudPage.<\/p>\n

NOTE: This function will not work on Profile Attribute Data Filters.<\/p>\n<\/blockquote>\n

Example<\/h3>\n

Data Extension<\/strong>: LoyaltyMembers<\/em><\/p>\n\n\n\n\n\n\n\n\n\n
Name<\/th>\nData Type<\/th>\nLength<\/th>\nPrimary Key<\/th>\nNullable<\/th>\nDefault Value<\/th>\n<\/tr>\n<\/thead>\n
EmailAddress<\/td>\nEmailAddress<\/td>\n254<\/td>\nN<\/td>\nN<\/td>\n<\/td>\n<\/tr>\n
SubscriberKey<\/td>\nText<\/td>\n254<\/td>\nY<\/td>\nN<\/td>\n<\/td>\n<\/tr>\n
FirstName<\/td>\nText<\/td>\n50<\/td>\nN<\/td>\nY<\/td>\n<\/td>\n<\/tr>\n
LastName<\/td>\nText<\/td>\n50<\/td>\nN<\/td>\nY<\/td>\n<\/td>\n<\/tr>\n
Created<\/td>\nDate<\/td>\n<\/td>\nN<\/td>\nY<\/td>\nCurrent Date<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The LoyaltyMembers<\/em> Data Extension includes these rows:<\/p>\n\n\n\n\n\n\n\n\n
EmailAddress<\/th>\nSubscriberKey<\/th>\nFirstName<\/th>\nLastName<\/th>\nCreated<\/th>\n<\/tr>\n<\/thead>\n
doug@limedash.com<\/td>\n8473<\/td>\nDoug<\/td>\nSmith<\/td>\n2017-10-21 12:01<\/td>\n<\/tr>\n
suzy@limedash.com<\/td>\n5497<\/td>\nSuzy<\/td>\nJackson<\/td>\n2017-10-20 11:01<\/td>\n<\/tr>\n
dale@limedash.com<\/td>\n7114<\/td>\nDale<\/td>\nCameron<\/td>\n2017-10-19 10:01<\/td>\n<\/tr>\n
barb@plumcomma.com<\/td>\n5767<\/td>\nBarb<\/td>\nBrown<\/td>\n2017-10-18 09:01<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Data Filter<\/strong>: DataExtension_Test_Sample_Emails<\/code><\/p>\n

    \n
  • Customer\/External Key: DataExtension_Test_Sample_Emails<\/code><\/li>\n
  • Email Address<\/code> contains limedash.com<\/code><\/li>\n<\/ul>\n

    Here is an example utilizing the preceding context:<\/p>\n

    %%[\n\nvar @rows, @row, @rowCount, @i\n\nset @rows = ExecuteFilter(\"DataExtension_Test_Example_Emails\")\nset @rowCount = rowcount(@rows)\n\nif @rowCount > 0 then\n\n  output(concat(\"rowCount: \", @rowCount))\n\n  for @i = 1 to @rowCount do\n\n    var @emailAddress\n    set @row = row(@rows, @i) \/* get row based on counter *\/\n    set @emailAddress = field(@row,\"emailAddress\")\n\n    ]%%\n\n    <br>Row %%=v(@i)=%%, emailAddress is %%=v(@emailAddress)=%%\n\n    %%[\n\n  next @i ]%%\n\n%%[ else ]%%\n\nNo rows found\n\n%%[ endif ]%%<\/code><\/pre>\n
    Output<\/h4>\n
    rowCount: 3\nRow 1, emailAddress is doug@limedash.com\nRow 2, emailAddress is suzy@limedash.com\nRow 3, emailAddress is dale@limedash.com<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
    ExecuteFilter This function executes the specified Data Extension Data Filter and returns a row set. Argument ExecuteFilter(1) Ordinal Type Required Description 1 String True Customer\/External Key of the Data Filter to execute NOTE: This function only works in a landing page, microsite page or CloudPage. NOTE: This function will not work on Profile Attribute Data […]<\/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 - ExecuteFilter<\/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\/executefilter\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"The AMPscript Guide - ExecuteFilter\" \/>\n<meta property=\"og:description\" content=\"ExecuteFilter This function executes the specified Data Extension Data Filter and returns a row set. Argument ExecuteFilter(1) Ordinal Type Required Description 1 String True Customer\/External Key of the Data Filter to execute NOTE: This function only works in a landing page, microsite page or CloudPage. NOTE: This function will not work on Profile Attribute Data […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ampscript.guide\/executefilter\/\" \/>\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:28+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\/executefilter\/#webpage\",\"url\":\"https:\/\/ampscript.guide\/executefilter\/\",\"name\":\"The AMPscript Guide - ExecuteFilter\",\"isPartOf\":{\"@id\":\"https:\/\/ampscript.guide\/#website\"},\"datePublished\":\"2018-04-21T15:47:46+00:00\",\"dateModified\":\"2021-04-06T01:18:28+00:00\",\"author\":{\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\"},\"breadcrumb\":{\"@id\":\"https:\/\/ampscript.guide\/executefilter\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ampscript.guide\/executefilter\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ampscript.guide\/executefilter\/#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\/executefilter\/\",\"url\":\"https:\/\/ampscript.guide\/executefilter\/\",\"name\":\"ExecuteFilter\"}}]},{\"@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\/31450"}],"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=31450"}],"version-history":[{"count":0,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31450\/revisions"}],"wp:attachment":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/media?parent=31450"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/categories?post=31450"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/tags?post=31450"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}