vtex-io-masterdata

Manage Master Data v2 entities and schemas with MasterDataClient in VTEX IO apps.

39|9|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/vtexdocs/ai-skills --skill vtex-io-masterdata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vtex-io-masterdata
Source: https://github.com/vtexdocs/ai-skills/tree/main/tracks/vtex-io/skills/vtex-io-masterdata
Command: npx skills add https://github.com/vtexdocs/ai-skills --skill vtex-io-masterdata

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

MasterData v2 integration for VTEX IO apps enables storing, querying, and managing custom data with JSON Schemas and MasterDataClient, preventing unstructured data and enabling automated workflows.

Core Features & Use Cases

  • Define data entities and JSON Schemas with the masterdata builder
  • Perform CRUD operations via MasterDataClient
  • Configure search, triggers, and schema lifecycle to avoid the 60-schema limit and ensure scalable data management

Quick Start

Set up your VTEX IO app to use MasterData v2 by defining JSON schemas, creating data entities, and performing CRUD operations through MasterDataClient.

Frequently Asked Questions about vtex-io-masterdata

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform CRUD operations on Master Data v2 entities inside a VTEX IO app?

Manage Master Data v2 entities by calling the MasterDataClient inside your VTEX IO app. It handles CRUD operations directly against your defined data entities using JSON schemas for structured data storage and retrieval.

What is the JSON schema lifecycle in Master Data v2 and why does it matter?

The JSON schema lifecycle in Master Data v2 governs how data entities are created, updated, and retired. Proper schema cleanup is critical to avoid hitting the 60-schema limit and ensure scalable data management across your VTEX IO apps.

How do I configure triggers and indexing for Master Data v2 data entities?

Configure triggers and indexing on Master Data v2 data entities to enable automated workflows and efficient data retrieval. Using the masterdata builder ensures your custom data automations run correctly within VTEX IO.

Can I use MasterDataClient to avoid the 60-schema limit in VTEX IO?

Yes, you can avoid the 60-schema limit by enforcing proper schema cleanup and lifecycle management with MasterDataClient. This approach ensures structured data management and prevents unstructured data accumulation in your VTEX IO apps.

What's the best way to set up search and pagination for Master Data v2 records?

The best way to search Master Data v2 records is using the MasterDataClient with proper pagination. This ensures efficient data retrieval and prevents performance issues when querying large datasets across your data entities.

Why do I need JSON schemas for custom data in VTEX IO Master Data v2?

You need JSON schemas for custom data in Master Data v2 to prevent unstructured data and enable automated workflows. Defining schemas with the masterdata builder ensures scalable data management and proper entity validation.