Update time: May 26, 2026
In Google Tag Manager (GTM), container limits define the restrictions Google imposes on container size, account numbers, workspaces, and other settings.
Understanding these limits is crucial for smooth GTM management.
Container Size
- Maximum Size: A GTM container can be up to 200KB.
- Size Warning: When the container reaches 70% of the maximum size (≈140KB), GTM will display a warning, prompting you to optimize the container. Check this by navigating to 「Versions」 in your GTM interface:
- Impact: Exceeding 200KB prevents you from publishing new versions until the container is optimized and reduced in size.
Account and Container Limits
- Account Limit: Each Google account can create up to 400 GTM accounts.
- Container Limit: Each GTM account can have up to 500 containers.
Other Limits
- Workspaces:
- Free Version: Up to 3 workspaces (including the default workspace).
- GTM 360: Unlimited workspaces.
- Custom HTML Tag:
- Free Version: Maximum 102,400 characters per tag.
- GTM 360: No character limit.
- Constant Variable: Maximum length：1,024 characters.
- Import File Size: Maximum size for container templates or recipes: 10MB.
- API Usage Limits:
- Daily Request Limit: Up to 10,000 requests per project per day.
- Queries Per Second (QPS) Limit: Up to 0.25 requests per project per second (≈25 requests per 100 seconds).
Optimization Tips
- Merge Tags: Use variables and data layers to reduce the amount of code.
- Clean Up Unused Content: Regularly remove unused tags, triggers, and variables.
- Use Lookup Tables: For complex configurations, lookup tables can simplify management, but watch their size.
- Zone Management: For very large websites, consider multiple containers or the Zones feature in GTM 360.
Key Takeaways
- GTM limits may change over time, so always check for updates.
- Exceeding these limits can disrupt GTM functionality, making regular container audits and optimizations essential.