Data Item

1{
2  "schemaVersion": 1,
3  "domain": "cms",
4  "entity": "data-item",
5  "displayName": "CMS Data Item",
6  "capability": "cms.data-item",
7  "target": {
8    "classification": "cms",
9    "nativeEntity": "Wix Data Item",
10    "verifiedFqdn": "wix.data.v2.data_item",
11    "idPolicy": "client-assigned",
12    "crosswalkRequired": false
13  },
14  "sourceAliases": [
15    {
16      "sourceSystem": "wordpress",
17      "sourceEntity": "custom_post_type_item",
18      "routes": [
19        "/wp/v2/{type}"
20      ],
21      "confidence": "medium"
22    },
23    {
24      "sourceSystem": "wix",
25      "sourceEntity": "cmsDataItem",
26      "routes": [
27        "Wix Data Items"
28      ],
29      "confidence": "high"
30    }
31  ],
32  "preferredWrite": {
33    "surface": "Wix Data Items",
34    "endpoint": "POST /wix-data/v2/items",
35    "writerId": "insertDataItem",
36    "verification": "verified-live",
37    "importSafe": true,
38    "bulk": false
39  },
40  "fallbacks": [],
41  "reliability": {
42    "status": "reliable",
43    "flags": []
44  },
45  "pitfalls": [
46    {
47      "code": "readonly-dates",
48      "severity": "warning",
49      "summary": "_createdDate and _updatedDate are read-only; preserve source dates in explicit fields."
50    },
51    {
52      "code": "bulk-save-replaces",
53      "severity": "warning",
54      "summary": "Bulk Save replaces complete items, so generated records must include all fields."
55    }
56  ],
57  "mappingGuidance": [
58    "Use client-supplied IDs where possible for recoverable CMS imports.",
59    "Large-volume alternative: the Data Movement Jobs API imports a file into a collection as an async job (Submit Job + Create File Upload Url). Per-item API writes stay preferred — deterministic per-row errors and crosswalk stamping — but evaluate the job channel live when a collection import is large enough that per-item calls dominate the run."
60  ],
61  "setupRequirements": [
62    "Wix Data enabled",
63    "Target collection exists before item writes."
64  ],
65  "evidence": [
66    
67    {
68      "type": "wix-docs",
69      "url": "https://dev.wix.com/docs/api-reference/business-solutions/cms/operations/data-movement-jobs/introduction",
70      "note": "file-to-collection bulk import jobs; evaluated at the docs-survey sweep 2026-08-11"
71    }
72  ]
73}