vtex-io-masterdata

To implement a persistence layer for custom data in VTEX IO apps, use Master Data v2 to define JSON Schemas, execute CRUD operations via MasterDataClient, and apply governance patterns to prevent data duplication.

Use Master Data v2 for custom business data when you need structured persistence with JSON Schemas and triggers, but avoid using it as a log, cache, or parallel source of truth to prevent unsafe architectural patterns.

The best way to manage JSON Schema lifecycle in VTEX IO Master Data is to apply decision rules for schema creation and handle the 60-schema limit by safely governing data entities across your projects.

To execute CRUD operations safely using MasterDataClient in VTEX IO, follow the MasterDataClient usage pattern provided by the builder to enforce schema governance and avoid misuse on critical paths.

Limitations of using Master Data as a persistence layer in VTEX IO include a strict 60-schema limit per project and architectural constraints preventing its use as a log, cache, or parallel source of truth.