wix-cli-data-collection

Define and manage CMS data collections for Wix CLI apps in a single extension file.

25|31|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/wix/skills --skill wix-cli-data-collection
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wix-cli-data-collection
Source: https://github.com/wix/skills/tree/main/wix-cli/skills/wix-cli-data-collection
Command: npx skills add https://github.com/wix/skills --skill wix-cli-data-collection

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill provides a unified way for Wix CLI app developers to define and register CMS data collections, enabling automatic creation of structured storage when a site installs the app.

Core Features & Use Cases

  • Single-file extension definition via extensions.genericExtension() so all collections are declared in one place
  • Namespace-aware collection IDs that are scoped to the app namespace to prevent conflicts
  • Flexible data modeling with fields, permissions, initialData, and optional references for relationships
  • Rapid scaffolding using the assets/extension-template.ts template to bootstrap a working data extension
  • Real-world use cases: modeling products, categories, users, or logs with CRUD permissions and initial seed data

Quick Start

Replace the example collection with your own in src/data/extensions.ts, then run the Wix CLI validation to verify and register your data extensions.

Frequently Asked Questions about wix-cli-data-collection

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

FAQPage Schema
How do I auto-create CMS data collections when a Wix app is installed?

To auto-create CMS data collections, define your schemas and initial data in a single data-extension file using extensions.genericExtension(). The Wix CLI validates and registers these collections for automatic creation upon site installation.

What's the best way to define structured storage and relationships for Wix CLI apps?

The best way to define structured storage is declaring fields, dataPermissions, initialData, and optional references in one data-extension file. This supports relationships and merges while satisfying the Wix Data Collections extension schema.

Can I scope CMS data collections to prevent namespace conflicts in Wix?

Yes, you can scope CMS data collections using namespace-aware collection IDs. This ensures your app's data collections are scoped to the app namespace, preventing conflicts when installed across different Wix sites.

How do I add seed data and CRUD permissions to a Wix CMS data collection?

You add seed data and CRUD permissions by declaring initialData and dataPermissions within your collection's schema definition in the data-extension file. This allows you to model entities like products or logs with specific access controls.

Do I need to manually create data collections on every site for my Wix app?

No, you do not need to manually create data collections. By declaring your schemas in a single data-extension file, the Wix CLI automatically creates the structured storage when a site installs your app.

How do I bootstrap a working data extension for Wix CMS collections?

You bootstrap a working data extension by copying the assets/extension-template.ts template. Replace the example collection with your own schema in src/data/extensions.ts, then run Wix CLI validation to verify.