You are here:
Custom Metadata Allocations and Usage Calculations
Understand requirements for custom metadata types and records and how your custom metadata type usage is calculated.
Required Editions
| Available in: Salesforce Classic and Lightning Experience |
Available in: Enterprise, Performance, Unlimited, and Developer Editions You can create, edit, and delete custom metadata type records from installed packages in: Group and Professional Editions |
*Record size is based on the maximum field size of each field type, not the actual storage that’s used in each field. When adding fields to a custom metadata record, use the appropriate type and specify a length that doesn’t exceed what’s needed for your data. This action helps you avoid reaching the cached data maximum. For example, if you create a US social security number (SSN) field, select the Text data type, and specify a length of 9. If you select Text Area, the field adds 255 characters to the usage count for each record, regardless of the number of characters entered.
Usage Calculation
- Usage is calculated in characters. You can store up to 10 million characters.
- Standard fields such as Label, Name, and Namespace are included in your usage calculation, but Description and Qualified API Name aren’t.
- Long text area fields, up to 255 characters per long text area field for a given type, are included in the usage calculation.
- Metadata relationship fields count as 15 characters in the usage calculation if their target is another custom metadata type, or 10 characters if the target is Entity Definition or Field Definition.
- Picklists and checkboxes count as 10 characters.
Retrieving Custom Metadata Type Information
When you retrieve custom metadata type records or a count of custom metadata types, the number returned by SOQL, Apex, formulas, flows, or APIs can differ from the number in the user interface. This difference is because of the custom metadata type visibility settings and the access a user has to the type based on profiles and permissions.

