Tag

1{
2  "schemaVersion": 1,
3  "domain": "blog",
4  "entity": "tag",
5  "displayName": "Blog Tag",
6  "capability": "content.blog-tag",
7  "target": {
8    "classification": "native",
9    "nativeEntity": "Blog Tag",
10    "verifiedFqdn": null,
11    "idPolicy": "server-assigned",
12    "crosswalkRequired": true
13  },
14  "sourceAliases": [
15    {
16      "sourceSystem": "wordpress",
17      "sourceEntity": "tag",
18      "routes": [
19        "/wp/v2/tags"
20      ],
21      "confidence": "high"
22    },
23    {
24      "sourceSystem": "wix",
25      "sourceEntity": "blogTag",
26      "routes": [
27        "Blog Tags"
28      ],
29      "confidence": "high"
30    }
31  ],
32  "preferredWrite": {
33    "surface": "Blog Tags",
34    "endpoint": "POST /blog/v3/tags",
35    "writerId": "createBlogTag",
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": "slug-derived",
48      "severity": "warning",
49      "summary": "Blog tag slug is derived; dedupe by label/language."
50    }
51  ],
52  "mappingGuidance": [
53    "Create tags before posts and crosswalk created or existing tag IDs."
54  ],
55  "setupRequirements": [
56    "Wix Blog app"
57  ],
58  "evidence": [
59    {
60      "type": "wix-docs",
61      "url": "https://dev.wix.com/docs/api-reference/business-solutions/blog/tags/tag-object",
62      "note": "object page (docs-survey sweep 2026-08-11)"
63    }
64    
65  ]
66}