Long Text Areas in Custom Metadata Types (Pilot)

Essential configuration data often runs longer than the 255-character text field limit. Until this release, storing longer strings, such as API keys, specialized markup, or SOQL queries, required workarounds using text fields. Now, you can create, package, and deploy long text areas as a custom field type.


We provide long text areas in custom metadata types to selected customers through a pilot program that requires agreement to specific terms and conditions. To be nominated to participate in the program, contact Salesforce. Pilot programs are subject to change, and we can’t guarantee acceptance. This feature isn’t generally available unless or until Salesforce announces its general availability in documentation or in press releases or public statements. We can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features. You can provide feedback and suggestions for this feature in the Custom Metadata Types group in the Success Community.

Keep in mind these limits and limitations.
  • Default character limit—32,768 (32 KB)
  • Maximum character limit—131,072 (128 KB)
  • Minimum character limit—256
  • Long text area fields aren’t supported in SOQL filters.
  • Long text area fields count toward the custom metadata 10 MB limit. 255 characters per long text area field count for a given type.
  • Queries containing long text area fields count toward Apex governor limits.