wix-cli-data-collection

Creates CMS data collection schemas for Wix CLI apps using the data collections extension.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/thisisjaymehta/login-with-email-test --skill wix-cli-data-collection-thisisjaymehta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wix-cli-data-collection
Source: https://github.com/thisisjaymehta/login-with-email-test/tree/main/.agents/skills/wix-cli-data-collection
Command: npx skills add https://github.com/thisisjaymehta/login-with-email-test --skill wix-cli-data-collection-thisisjaymehta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @wix/astro/builders, and includes assets (resource) components.

What problem does it solve? Defining structured data storage for Wix CLI apps requires precise knowledge of the data collections extension format, field types, permission levels, and namespace scoping. This Skill generates correct collection definitions in src/extensions/data/extensions.ts without manual schema research. ## Core Features & Use Cases - Collection Schema Generation: Defines collections with idSuffix, display names, fields, and permissions using extensions.genericExtension() from @wix/astro/builders. - Field Types & Relationships: Supports 24 field types including REFERENCE and MULTI_REFERENCE for linking custom collections, with strict rules against referencing Wix business entities. - Context-Based Permissions: Configures read/write access levels (ANYONE, SITE_MEMBER, CMS_EDITOR, PRIVILEGED) matched to where data is consumed, such as site widgets versus dashboard pages. - Use Case: When building a Wix app with a reviews widget, generate a reviews collection with public read access, member insert permissions, and initial seed data, all registered correctly with a static UUID. ## Quick Start Ask the AI to create a Wix CMS data collection for your app, specifying the collection name, fields, and who should be able to read or write the data.

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 create a CMS data collection in a Wix CLI app?

Define collections in `src/extensions/data/extensions.ts` using `extensions.genericExtension()` from `@wix/astro/builders` with compType `DATA_COMPONENT`. Each collection needs an `idSuffix`, displayName, fields array, and dataPermissions, plus a static UUID as the compId.

What field types are available for Wix data collections?

Wix data collections support 24 field types including TEXT, NUMBER, BOOLEAN, DATE, DATETIME, IMAGE, REFERENCE, MULTI_REFERENCE, OBJECT, and ARRAY variants. OBJECT fields require an `objectOptions` property, and REFERENCE fields can only link to other custom collections in the same app.

Can Wix data collections reference Wix Products or Contacts?

No, REFERENCE and MULTI_REFERENCE fields can only link to custom CMS collections defined in your own app via their idSuffix. To access Wix business entities like Products, Orders, or Members, use the Wix SDK APIs instead of collection references.

Why does my Wix site widget return empty collection data?

The collection's `itemRead` permission is likely set too restrictively, such as PRIVILEGED, while site visitors only have public access. Set `itemRead` to ANYONE for collections queried by site widgets or embedded scripts, since permissions must match the least privileged access context.

When should I use embedded script parameters instead of CMS collections?

Use embedded script parameters for any configuration controlling how a script behaves or appears, such as colors, headlines, toggles, or thresholds. CMS collections should only store business data, user-generated content, or multi-record relational data, never single-value configuration.