{
  "schemaVersion": 1,
  "domain": "media",
  "entity": "media-folder",
  "displayName": "Media Folder",
  "capability": "media.folder",
  "target": {
    "classification": "native-plus-cms",
    "nativeEntity": "Media Manager Folder",
    "verifiedFqdn": null,
    "idPolicy": "server-assigned",
    "crosswalkRequired": true
  },
  "sourceAliases": [
    {
      "sourceSystem": "wordpress",
      "sourceEntity": "media_folder",
      "routes": [
        "plugin-specific media folder routes"
      ],
      "confidence": "low"
    },
    {
      "sourceSystem": "wix",
      "sourceEntity": "mediaFolder",
      "routes": [
        "Media Manager folders"
      ],
      "confidence": "high"
    }
  ],
  "preferredWrite": {
    "surface": "Media Manager Folders",
    "endpoint": null,
    "writerId": null,
    "verification": "unverified",
    "importSafe": true,
    "bulk": false
  },
  "fallbacks": [
    {
      "classification": "cms",
      "when": "Use for source folder hierarchy if native folder creation is not in scope."
    }
  ],
  "reliability": {
    "status": "partially-reliable",
    "flags": []
  },
  "pitfalls": [
    {
      "code": "folder-writer-unverified",
      "severity": "warning",
      "summary": "Do not require folder creation for media file preservation unless verified for the project."
    }
  ],
  "mappingGuidance": [
    "Preserve folders as metadata when only file import is required."
  ],
  "setupRequirements": [],
  "evidence": [
    {
      "type": "wix-docs",
      "url": "https://dev.wix.com/docs/api-reference/assets/media/media-manager/folders/folder-object",
      "note": "object page (docs-survey sweep 2026-08-11)"
    }
    
  ]
}