Change Custom Object Retrieval Limits in Velocity Scripting

If you use Velocity Script to display Custom Object data in emails, this feature might be for you. By default, you’re allowed access to 10 parent custom objects from Velocity Script. If you need to access more, read on.

What is Velocity

Apache Velocity is a language built on Java designed for templating and scripting HTML content. Marketo allows it to be used in the context of Emails through the use of scripting tokens. Among other things, this gives access to data stored in custom objects.

You can reference parent and child custom objects that are directly connected to the Lead, or Contact, but not third-level custom objects. For each custom object, the 10 most recently updated records per person/contact are available at runtime and are ordered from most recently updated (at 0) to oldest updated (at 9).

How to Change the Limit

  1. Go to the Admin section.

  2. Click Email.

  3. In the Custom Object Retrieval Limits table, enter a new Parent Retrieval Limit and click Save Changes.

NOTE

The Parent Retrieval Limit value must be in the range of 10 - 100. The Child Retrieval Limit is set automatically for you. This is done by dividing 1000 by the Parent Retrieval Limit. For example, if you set the Parent limit to 50, the Child limit becomes 20 (1000 ÷ 50 = 20).

Sweet! Now you can access more custom objects from Velocity script.

On this page