[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-payload-cms-migration":3,"mdc-8w0wfw-key":35,"related-repo-payload-cms-migration":1114,"related-org-payload-cms-migration":1136},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":20,"repoUrl":21,"updatedAt":22,"license":23,"forks":24,"topics":25,"repo":30,"sourceUrl":33,"mdContent":34},"cms-migration","migrate content to Payload CMS","Use when user wants to migrate content from another CMS (WordPress, Contentful, Strapi, Sanity, Webflow, etc.) to Payload CMS",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"payload","Payload CMS","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fpayload.jpg","payloadcms",[13,17],{"name":14,"slug":15,"type":16},"CMS","cms","tag",{"name":18,"slug":19,"type":16},"Migration","migration",135,"https:\u002F\u002Fgithub.com\u002Fpayloadcms\u002Fskills","2026-07-13T05:59:59.365585",null,4,[26,27,28,8,11,29],"ai","ai-agents","ai-skills","skills",{"repoUrl":21,"stars":20,"forks":24,"topics":31,"description":32},[26,27,28,8,11,29],"Payload Skills to assist AI agents","https:\u002F\u002Fgithub.com\u002Fpayloadcms\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Fcms-migration","---\nname: cms-migration\ndescription: Use when user wants to migrate content from another CMS (WordPress, Contentful, Strapi, Sanity, Webflow, etc.) to Payload CMS\n---\n\n# CMS Migration to Payload\n\nInteractive workflow to design Payload collections from source CMS data. Config-first approach: establish the data structure through conversation before any data import.\n\n## Workflow\n\n```\nStart\n  ↓\nAsk for data sample\n  ↓\nAnalyze data shape\n  ↓\nPropose collection config\n  ↓\nUser reviews ──────────────┐\n  │                        │\n  ├─ changes needed ───→ Adjust config ──→ (back to User reviews)\n  │\n  └─ looks good ───→ Config confirmed\n                            ↓\n                    More collections? ──────┐\n                            │               │\n                            ├─ yes ──→ (back to Ask for data sample)\n                            │\n                            └─ no ───→ All collections confirmed\n                                              ↓\n                                      Discuss migration approach\n                                              ↓\n                                            Done\n```\n\n## Phase 1: Data Analysis\n\nWhen user provides data (JSON, CSV, or describes their schema):\n\n1. **Identify field types** - text, number, date, relationships, media, rich text\n2. **Spot patterns** - IDs, timestamps, nested objects, arrays\n3. **Note relationships** - foreign keys, embedded refs, linked content types\n4. **Flag ambiguities** - fields that could be multiple types, unclear purposes\n\n## Phase 2: Propose Collection Config\n\nPresent a Payload collection config based on analysis:\n\n```typescript\n\u002F\u002F Example output format\nexport const Posts: CollectionConfig = {\n  slug: 'posts',\n  fields: [\n    { name: 'title', type: 'text', required: true },\n    { name: 'content', type: 'richText' },\n    { name: 'author', type: 'relationship', relationTo: 'users' },\n    \u002F\u002F ...\n  ],\n}\n```\n\nExplain your reasoning for each field choice. When something could go multiple ways (group vs JSON, text vs textarea, select vs relationship), ask rather than assume.\n\n## Phase 3: Iterate with User\n\nWork through uncertainties: required fields, hasMany relationships, rich text vs HTML, custom timestamps vs built-in. Continue until the user confirms the config.\n\n## Phase 4: Additional Collections\n\nAfter each confirmation, ask:\n\n> \"Are there other content types we should create collections for?\"\n\nIf yes, loop back to Phase 1 with new data sample.\n\nCommon related collections to prompt for:\n- Media\u002Fuploads\n- Users\u002Fauthors\n- Categories\u002Ftags\n- Settings (global)\n\n## Phase 5: Migration Approach\n\nOnly after ALL collections are confirmed, discuss data import:\n\n1. **Order matters** - which collections have no dependencies? Migrate those first\n2. **Relationship mapping** - how to resolve source IDs to Payload IDs\n3. **Media handling** - download\u002Fre-upload vs external URLs\n4. **Rich text** - HTML conversion needs or keep raw\n\nOffer to generate a seed script or walk through manual import.\n\n## Things to Clarify\n\nThroughout the process, watch for these:\n\n- **ID references** - are they relationships to other collections?\n- **Image\u002Ffile URLs** - upload fields or keep as external URLs?\n- **Nested objects** - group, array, or blocks?\n- **Localization** - any fields need per-locale values?\n- **Access control** - who can read\u002Fwrite this collection?\n- **Related content types** - categories, tags, authors that need their own collections?\n\n## Critical: Select vs Relationship\n\n**This is the most common migration mistake.** Data that looks static often needs to be dynamic.\n\nWhen you see repeated string values (categories, tags, types, statuses):\n\n```json\n{ \"category\": \"Technology\" }\n{ \"category\": \"News\" }\n{ \"category\": \"Technology\" }\n```\n\n**Don't assume it's a select field.** Ask:\n\n> \"I see `category` has values like 'Technology', 'News'. Should this be:\n> - A **select field** with fixed options (values won't change)\n> - A **relationship** to a Categories collection (users can add\u002Fedit\u002Fremove categories later)\"\n\n**Default to relationship** for anything that looks like:\n- Categories, tags, topics, labels\n- Authors, assignees, reviewers\n- Statuses beyond simple draft\u002Fpublished\n- Types that might expand over time\n\n**Use select only for:**\n- Truly fixed enums (yes\u002Fno, draft\u002Fpublished\u002Farchived)\n- Options defined by business logic, not content (payment status, priority levels)\n- Values that would break functionality if changed (role types with code dependencies)\n\nIf creating a relationship, remember to add the related collection (Categories, Tags, etc.) to the migration plan.\n\n## Reference Documentation\n\n- **[PAYLOAD-FIELD-REFERENCE.md](reference\u002FPAYLOAD-FIELD-REFERENCE.md)** - Complete Payload field type schemas with examples\n\n## Common Pitfalls\n\n| Issue | How to Handle |\n|-------|---------------|\n| User provides partial data | Ask for more samples, especially edge cases |\n| Unclear relationships | Ask user to describe how content types connect |\n| Rich text ambiguity | Clarify: Lexical editor, Slate, or store raw HTML |\n| Missing media collection | Always confirm upload collection exists before referencing |\n| Overly complex nested data | Consider flattening or using blocks instead of deep groups |\n",{"data":36,"body":37},{"name":4,"description":6},{"type":38,"children":39},"root",[40,49,55,62,75,81,86,132,138,143,514,519,525,530,536,541,550,555,560,584,590,595,638,643,649,654,717,723,733,738,871,881,921,931,954,962,980,985,991,1009,1015,1108],{"type":41,"tag":42,"props":43,"children":45},"element","h1",{"id":44},"cms-migration-to-payload",[46],{"type":47,"value":48},"text","CMS Migration to Payload",{"type":41,"tag":50,"props":51,"children":52},"p",{},[53],{"type":47,"value":54},"Interactive workflow to design Payload collections from source CMS data. Config-first approach: establish the data structure through conversation before any data import.",{"type":41,"tag":56,"props":57,"children":59},"h2",{"id":58},"workflow",[60],{"type":47,"value":61},"Workflow",{"type":41,"tag":63,"props":64,"children":68},"pre",{"className":65,"code":67,"language":47},[66],"language-text","Start\n  ↓\nAsk for data sample\n  ↓\nAnalyze data shape\n  ↓\nPropose collection config\n  ↓\nUser reviews ──────────────┐\n  │                        │\n  ├─ changes needed ───→ Adjust config ──→ (back to User reviews)\n  │\n  └─ looks good ───→ Config confirmed\n                            ↓\n                    More collections? ──────┐\n                            │               │\n                            ├─ yes ──→ (back to Ask for data sample)\n                            │\n                            └─ no ───→ All collections confirmed\n                                              ↓\n                                      Discuss migration approach\n                                              ↓\n                                            Done\n",[69],{"type":41,"tag":70,"props":71,"children":73},"code",{"__ignoreMap":72},"",[74],{"type":47,"value":67},{"type":41,"tag":56,"props":76,"children":78},{"id":77},"phase-1-data-analysis",[79],{"type":47,"value":80},"Phase 1: Data Analysis",{"type":41,"tag":50,"props":82,"children":83},{},[84],{"type":47,"value":85},"When user provides data (JSON, CSV, or describes their schema):",{"type":41,"tag":87,"props":88,"children":89},"ol",{},[90,102,112,122],{"type":41,"tag":91,"props":92,"children":93},"li",{},[94,100],{"type":41,"tag":95,"props":96,"children":97},"strong",{},[98],{"type":47,"value":99},"Identify field types",{"type":47,"value":101}," - text, number, date, relationships, media, rich text",{"type":41,"tag":91,"props":103,"children":104},{},[105,110],{"type":41,"tag":95,"props":106,"children":107},{},[108],{"type":47,"value":109},"Spot patterns",{"type":47,"value":111}," - IDs, timestamps, nested objects, arrays",{"type":41,"tag":91,"props":113,"children":114},{},[115,120],{"type":41,"tag":95,"props":116,"children":117},{},[118],{"type":47,"value":119},"Note relationships",{"type":47,"value":121}," - foreign keys, embedded refs, linked content types",{"type":41,"tag":91,"props":123,"children":124},{},[125,130],{"type":41,"tag":95,"props":126,"children":127},{},[128],{"type":47,"value":129},"Flag ambiguities",{"type":47,"value":131}," - fields that could be multiple types, unclear purposes",{"type":41,"tag":56,"props":133,"children":135},{"id":134},"phase-2-propose-collection-config",[136],{"type":47,"value":137},"Phase 2: Propose Collection Config",{"type":41,"tag":50,"props":139,"children":140},{},[141],{"type":47,"value":142},"Present a Payload collection config based on analysis:",{"type":41,"tag":63,"props":144,"children":148},{"className":145,"code":146,"language":147,"meta":72,"style":72},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u002F\u002F Example output format\nexport const Posts: CollectionConfig = {\n  slug: 'posts',\n  fields: [\n    { name: 'title', type: 'text', required: true },\n    { name: 'content', type: 'richText' },\n    { name: 'author', type: 'relationship', relationTo: 'users' },\n    \u002F\u002F ...\n  ],\n}\n","typescript",[149],{"type":41,"tag":70,"props":150,"children":151},{"__ignoreMap":72},[152,164,208,243,260,341,399,483,492,505],{"type":41,"tag":153,"props":154,"children":157},"span",{"class":155,"line":156},"line",1,[158],{"type":41,"tag":153,"props":159,"children":161},{"style":160},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[162],{"type":47,"value":163},"\u002F\u002F Example output format\n",{"type":41,"tag":153,"props":165,"children":167},{"class":155,"line":166},2,[168,174,180,186,192,198,203],{"type":41,"tag":153,"props":169,"children":171},{"style":170},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[172],{"type":47,"value":173},"export",{"type":41,"tag":153,"props":175,"children":177},{"style":176},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[178],{"type":47,"value":179}," const",{"type":41,"tag":153,"props":181,"children":183},{"style":182},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[184],{"type":47,"value":185}," Posts",{"type":41,"tag":153,"props":187,"children":189},{"style":188},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[190],{"type":47,"value":191},":",{"type":41,"tag":153,"props":193,"children":195},{"style":194},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[196],{"type":47,"value":197}," CollectionConfig",{"type":41,"tag":153,"props":199,"children":200},{"style":188},[201],{"type":47,"value":202}," =",{"type":41,"tag":153,"props":204,"children":205},{"style":188},[206],{"type":47,"value":207}," {\n",{"type":41,"tag":153,"props":209,"children":211},{"class":155,"line":210},3,[212,218,222,227,233,238],{"type":41,"tag":153,"props":213,"children":215},{"style":214},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[216],{"type":47,"value":217},"  slug",{"type":41,"tag":153,"props":219,"children":220},{"style":188},[221],{"type":47,"value":191},{"type":41,"tag":153,"props":223,"children":224},{"style":188},[225],{"type":47,"value":226}," '",{"type":41,"tag":153,"props":228,"children":230},{"style":229},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[231],{"type":47,"value":232},"posts",{"type":41,"tag":153,"props":234,"children":235},{"style":188},[236],{"type":47,"value":237},"'",{"type":41,"tag":153,"props":239,"children":240},{"style":188},[241],{"type":47,"value":242},",\n",{"type":41,"tag":153,"props":244,"children":245},{"class":155,"line":24},[246,251,255],{"type":41,"tag":153,"props":247,"children":248},{"style":214},[249],{"type":47,"value":250},"  fields",{"type":41,"tag":153,"props":252,"children":253},{"style":188},[254],{"type":47,"value":191},{"type":41,"tag":153,"props":256,"children":257},{"style":182},[258],{"type":47,"value":259}," [\n",{"type":41,"tag":153,"props":261,"children":263},{"class":155,"line":262},5,[264,269,274,278,282,287,291,296,301,305,309,313,317,321,326,330,336],{"type":41,"tag":153,"props":265,"children":266},{"style":188},[267],{"type":47,"value":268},"    {",{"type":41,"tag":153,"props":270,"children":271},{"style":214},[272],{"type":47,"value":273}," name",{"type":41,"tag":153,"props":275,"children":276},{"style":188},[277],{"type":47,"value":191},{"type":41,"tag":153,"props":279,"children":280},{"style":188},[281],{"type":47,"value":226},{"type":41,"tag":153,"props":283,"children":284},{"style":229},[285],{"type":47,"value":286},"title",{"type":41,"tag":153,"props":288,"children":289},{"style":188},[290],{"type":47,"value":237},{"type":41,"tag":153,"props":292,"children":293},{"style":188},[294],{"type":47,"value":295},",",{"type":41,"tag":153,"props":297,"children":298},{"style":214},[299],{"type":47,"value":300}," type",{"type":41,"tag":153,"props":302,"children":303},{"style":188},[304],{"type":47,"value":191},{"type":41,"tag":153,"props":306,"children":307},{"style":188},[308],{"type":47,"value":226},{"type":41,"tag":153,"props":310,"children":311},{"style":229},[312],{"type":47,"value":47},{"type":41,"tag":153,"props":314,"children":315},{"style":188},[316],{"type":47,"value":237},{"type":41,"tag":153,"props":318,"children":319},{"style":188},[320],{"type":47,"value":295},{"type":41,"tag":153,"props":322,"children":323},{"style":214},[324],{"type":47,"value":325}," required",{"type":41,"tag":153,"props":327,"children":328},{"style":188},[329],{"type":47,"value":191},{"type":41,"tag":153,"props":331,"children":333},{"style":332},"--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC",[334],{"type":47,"value":335}," true",{"type":41,"tag":153,"props":337,"children":338},{"style":188},[339],{"type":47,"value":340}," },\n",{"type":41,"tag":153,"props":342,"children":344},{"class":155,"line":343},6,[345,349,353,357,361,366,370,374,378,382,386,391,395],{"type":41,"tag":153,"props":346,"children":347},{"style":188},[348],{"type":47,"value":268},{"type":41,"tag":153,"props":350,"children":351},{"style":214},[352],{"type":47,"value":273},{"type":41,"tag":153,"props":354,"children":355},{"style":188},[356],{"type":47,"value":191},{"type":41,"tag":153,"props":358,"children":359},{"style":188},[360],{"type":47,"value":226},{"type":41,"tag":153,"props":362,"children":363},{"style":229},[364],{"type":47,"value":365},"content",{"type":41,"tag":153,"props":367,"children":368},{"style":188},[369],{"type":47,"value":237},{"type":41,"tag":153,"props":371,"children":372},{"style":188},[373],{"type":47,"value":295},{"type":41,"tag":153,"props":375,"children":376},{"style":214},[377],{"type":47,"value":300},{"type":41,"tag":153,"props":379,"children":380},{"style":188},[381],{"type":47,"value":191},{"type":41,"tag":153,"props":383,"children":384},{"style":188},[385],{"type":47,"value":226},{"type":41,"tag":153,"props":387,"children":388},{"style":229},[389],{"type":47,"value":390},"richText",{"type":41,"tag":153,"props":392,"children":393},{"style":188},[394],{"type":47,"value":237},{"type":41,"tag":153,"props":396,"children":397},{"style":188},[398],{"type":47,"value":340},{"type":41,"tag":153,"props":400,"children":402},{"class":155,"line":401},7,[403,407,411,415,419,424,428,432,436,440,444,449,453,457,462,466,470,475,479],{"type":41,"tag":153,"props":404,"children":405},{"style":188},[406],{"type":47,"value":268},{"type":41,"tag":153,"props":408,"children":409},{"style":214},[410],{"type":47,"value":273},{"type":41,"tag":153,"props":412,"children":413},{"style":188},[414],{"type":47,"value":191},{"type":41,"tag":153,"props":416,"children":417},{"style":188},[418],{"type":47,"value":226},{"type":41,"tag":153,"props":420,"children":421},{"style":229},[422],{"type":47,"value":423},"author",{"type":41,"tag":153,"props":425,"children":426},{"style":188},[427],{"type":47,"value":237},{"type":41,"tag":153,"props":429,"children":430},{"style":188},[431],{"type":47,"value":295},{"type":41,"tag":153,"props":433,"children":434},{"style":214},[435],{"type":47,"value":300},{"type":41,"tag":153,"props":437,"children":438},{"style":188},[439],{"type":47,"value":191},{"type":41,"tag":153,"props":441,"children":442},{"style":188},[443],{"type":47,"value":226},{"type":41,"tag":153,"props":445,"children":446},{"style":229},[447],{"type":47,"value":448},"relationship",{"type":41,"tag":153,"props":450,"children":451},{"style":188},[452],{"type":47,"value":237},{"type":41,"tag":153,"props":454,"children":455},{"style":188},[456],{"type":47,"value":295},{"type":41,"tag":153,"props":458,"children":459},{"style":214},[460],{"type":47,"value":461}," relationTo",{"type":41,"tag":153,"props":463,"children":464},{"style":188},[465],{"type":47,"value":191},{"type":41,"tag":153,"props":467,"children":468},{"style":188},[469],{"type":47,"value":226},{"type":41,"tag":153,"props":471,"children":472},{"style":229},[473],{"type":47,"value":474},"users",{"type":41,"tag":153,"props":476,"children":477},{"style":188},[478],{"type":47,"value":237},{"type":41,"tag":153,"props":480,"children":481},{"style":188},[482],{"type":47,"value":340},{"type":41,"tag":153,"props":484,"children":486},{"class":155,"line":485},8,[487],{"type":41,"tag":153,"props":488,"children":489},{"style":160},[490],{"type":47,"value":491},"    \u002F\u002F ...\n",{"type":41,"tag":153,"props":493,"children":495},{"class":155,"line":494},9,[496,501],{"type":41,"tag":153,"props":497,"children":498},{"style":182},[499],{"type":47,"value":500},"  ]",{"type":41,"tag":153,"props":502,"children":503},{"style":188},[504],{"type":47,"value":242},{"type":41,"tag":153,"props":506,"children":508},{"class":155,"line":507},10,[509],{"type":41,"tag":153,"props":510,"children":511},{"style":188},[512],{"type":47,"value":513},"}\n",{"type":41,"tag":50,"props":515,"children":516},{},[517],{"type":47,"value":518},"Explain your reasoning for each field choice. When something could go multiple ways (group vs JSON, text vs textarea, select vs relationship), ask rather than assume.",{"type":41,"tag":56,"props":520,"children":522},{"id":521},"phase-3-iterate-with-user",[523],{"type":47,"value":524},"Phase 3: Iterate with User",{"type":41,"tag":50,"props":526,"children":527},{},[528],{"type":47,"value":529},"Work through uncertainties: required fields, hasMany relationships, rich text vs HTML, custom timestamps vs built-in. Continue until the user confirms the config.",{"type":41,"tag":56,"props":531,"children":533},{"id":532},"phase-4-additional-collections",[534],{"type":47,"value":535},"Phase 4: Additional Collections",{"type":41,"tag":50,"props":537,"children":538},{},[539],{"type":47,"value":540},"After each confirmation, ask:",{"type":41,"tag":542,"props":543,"children":544},"blockquote",{},[545],{"type":41,"tag":50,"props":546,"children":547},{},[548],{"type":47,"value":549},"\"Are there other content types we should create collections for?\"",{"type":41,"tag":50,"props":551,"children":552},{},[553],{"type":47,"value":554},"If yes, loop back to Phase 1 with new data sample.",{"type":41,"tag":50,"props":556,"children":557},{},[558],{"type":47,"value":559},"Common related collections to prompt for:",{"type":41,"tag":561,"props":562,"children":563},"ul",{},[564,569,574,579],{"type":41,"tag":91,"props":565,"children":566},{},[567],{"type":47,"value":568},"Media\u002Fuploads",{"type":41,"tag":91,"props":570,"children":571},{},[572],{"type":47,"value":573},"Users\u002Fauthors",{"type":41,"tag":91,"props":575,"children":576},{},[577],{"type":47,"value":578},"Categories\u002Ftags",{"type":41,"tag":91,"props":580,"children":581},{},[582],{"type":47,"value":583},"Settings (global)",{"type":41,"tag":56,"props":585,"children":587},{"id":586},"phase-5-migration-approach",[588],{"type":47,"value":589},"Phase 5: Migration Approach",{"type":41,"tag":50,"props":591,"children":592},{},[593],{"type":47,"value":594},"Only after ALL collections are confirmed, discuss data import:",{"type":41,"tag":87,"props":596,"children":597},{},[598,608,618,628],{"type":41,"tag":91,"props":599,"children":600},{},[601,606],{"type":41,"tag":95,"props":602,"children":603},{},[604],{"type":47,"value":605},"Order matters",{"type":47,"value":607}," - which collections have no dependencies? Migrate those first",{"type":41,"tag":91,"props":609,"children":610},{},[611,616],{"type":41,"tag":95,"props":612,"children":613},{},[614],{"type":47,"value":615},"Relationship mapping",{"type":47,"value":617}," - how to resolve source IDs to Payload IDs",{"type":41,"tag":91,"props":619,"children":620},{},[621,626],{"type":41,"tag":95,"props":622,"children":623},{},[624],{"type":47,"value":625},"Media handling",{"type":47,"value":627}," - download\u002Fre-upload vs external URLs",{"type":41,"tag":91,"props":629,"children":630},{},[631,636],{"type":41,"tag":95,"props":632,"children":633},{},[634],{"type":47,"value":635},"Rich text",{"type":47,"value":637}," - HTML conversion needs or keep raw",{"type":41,"tag":50,"props":639,"children":640},{},[641],{"type":47,"value":642},"Offer to generate a seed script or walk through manual import.",{"type":41,"tag":56,"props":644,"children":646},{"id":645},"things-to-clarify",[647],{"type":47,"value":648},"Things to Clarify",{"type":41,"tag":50,"props":650,"children":651},{},[652],{"type":47,"value":653},"Throughout the process, watch for these:",{"type":41,"tag":561,"props":655,"children":656},{},[657,667,677,687,697,707],{"type":41,"tag":91,"props":658,"children":659},{},[660,665],{"type":41,"tag":95,"props":661,"children":662},{},[663],{"type":47,"value":664},"ID references",{"type":47,"value":666}," - are they relationships to other collections?",{"type":41,"tag":91,"props":668,"children":669},{},[670,675],{"type":41,"tag":95,"props":671,"children":672},{},[673],{"type":47,"value":674},"Image\u002Ffile URLs",{"type":47,"value":676}," - upload fields or keep as external URLs?",{"type":41,"tag":91,"props":678,"children":679},{},[680,685],{"type":41,"tag":95,"props":681,"children":682},{},[683],{"type":47,"value":684},"Nested objects",{"type":47,"value":686}," - group, array, or blocks?",{"type":41,"tag":91,"props":688,"children":689},{},[690,695],{"type":41,"tag":95,"props":691,"children":692},{},[693],{"type":47,"value":694},"Localization",{"type":47,"value":696}," - any fields need per-locale values?",{"type":41,"tag":91,"props":698,"children":699},{},[700,705],{"type":41,"tag":95,"props":701,"children":702},{},[703],{"type":47,"value":704},"Access control",{"type":47,"value":706}," - who can read\u002Fwrite this collection?",{"type":41,"tag":91,"props":708,"children":709},{},[710,715],{"type":41,"tag":95,"props":711,"children":712},{},[713],{"type":47,"value":714},"Related content types",{"type":47,"value":716}," - categories, tags, authors that need their own collections?",{"type":41,"tag":56,"props":718,"children":720},{"id":719},"critical-select-vs-relationship",[721],{"type":47,"value":722},"Critical: Select vs Relationship",{"type":41,"tag":50,"props":724,"children":725},{},[726,731],{"type":41,"tag":95,"props":727,"children":728},{},[729],{"type":47,"value":730},"This is the most common migration mistake.",{"type":47,"value":732}," Data that looks static often needs to be dynamic.",{"type":41,"tag":50,"props":734,"children":735},{},[736],{"type":47,"value":737},"When you see repeated string values (categories, tags, types, statuses):",{"type":41,"tag":63,"props":739,"children":743},{"className":740,"code":741,"language":742,"meta":72,"style":72},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{ \"category\": \"Technology\" }\n{ \"category\": \"News\" }\n{ \"category\": \"Technology\" }\n","json",[744],{"type":41,"tag":70,"props":745,"children":746},{"__ignoreMap":72},[747,792,832],{"type":41,"tag":153,"props":748,"children":749},{"class":155,"line":156},[750,755,760,765,770,774,778,783,787],{"type":41,"tag":153,"props":751,"children":752},{"style":188},[753],{"type":47,"value":754},"{",{"type":41,"tag":153,"props":756,"children":757},{"style":188},[758],{"type":47,"value":759}," \"",{"type":41,"tag":153,"props":761,"children":762},{"style":176},[763],{"type":47,"value":764},"category",{"type":41,"tag":153,"props":766,"children":767},{"style":188},[768],{"type":47,"value":769},"\"",{"type":41,"tag":153,"props":771,"children":772},{"style":188},[773],{"type":47,"value":191},{"type":41,"tag":153,"props":775,"children":776},{"style":188},[777],{"type":47,"value":759},{"type":41,"tag":153,"props":779,"children":780},{"style":229},[781],{"type":47,"value":782},"Technology",{"type":41,"tag":153,"props":784,"children":785},{"style":188},[786],{"type":47,"value":769},{"type":41,"tag":153,"props":788,"children":789},{"style":188},[790],{"type":47,"value":791}," }\n",{"type":41,"tag":153,"props":793,"children":794},{"class":155,"line":166},[795,799,803,807,811,815,819,824,828],{"type":41,"tag":153,"props":796,"children":797},{"style":188},[798],{"type":47,"value":754},{"type":41,"tag":153,"props":800,"children":801},{"style":188},[802],{"type":47,"value":759},{"type":41,"tag":153,"props":804,"children":805},{"style":176},[806],{"type":47,"value":764},{"type":41,"tag":153,"props":808,"children":809},{"style":188},[810],{"type":47,"value":769},{"type":41,"tag":153,"props":812,"children":813},{"style":188},[814],{"type":47,"value":191},{"type":41,"tag":153,"props":816,"children":817},{"style":188},[818],{"type":47,"value":759},{"type":41,"tag":153,"props":820,"children":821},{"style":229},[822],{"type":47,"value":823},"News",{"type":41,"tag":153,"props":825,"children":826},{"style":188},[827],{"type":47,"value":769},{"type":41,"tag":153,"props":829,"children":830},{"style":188},[831],{"type":47,"value":791},{"type":41,"tag":153,"props":833,"children":834},{"class":155,"line":210},[835,839,843,847,851,855,859,863,867],{"type":41,"tag":153,"props":836,"children":837},{"style":188},[838],{"type":47,"value":754},{"type":41,"tag":153,"props":840,"children":841},{"style":188},[842],{"type":47,"value":759},{"type":41,"tag":153,"props":844,"children":845},{"style":176},[846],{"type":47,"value":764},{"type":41,"tag":153,"props":848,"children":849},{"style":188},[850],{"type":47,"value":769},{"type":41,"tag":153,"props":852,"children":853},{"style":188},[854],{"type":47,"value":191},{"type":41,"tag":153,"props":856,"children":857},{"style":188},[858],{"type":47,"value":759},{"type":41,"tag":153,"props":860,"children":861},{"style":229},[862],{"type":47,"value":782},{"type":41,"tag":153,"props":864,"children":865},{"style":188},[866],{"type":47,"value":769},{"type":41,"tag":153,"props":868,"children":869},{"style":188},[870],{"type":47,"value":791},{"type":41,"tag":50,"props":872,"children":873},{},[874,879],{"type":41,"tag":95,"props":875,"children":876},{},[877],{"type":47,"value":878},"Don't assume it's a select field.",{"type":47,"value":880}," Ask:",{"type":41,"tag":542,"props":882,"children":883},{},[884,896],{"type":41,"tag":50,"props":885,"children":886},{},[887,889,894],{"type":47,"value":888},"\"I see ",{"type":41,"tag":70,"props":890,"children":892},{"className":891},[],[893],{"type":47,"value":764},{"type":47,"value":895}," has values like 'Technology', 'News'. Should this be:",{"type":41,"tag":561,"props":897,"children":898},{},[899,911],{"type":41,"tag":91,"props":900,"children":901},{},[902,904,909],{"type":47,"value":903},"A ",{"type":41,"tag":95,"props":905,"children":906},{},[907],{"type":47,"value":908},"select field",{"type":47,"value":910}," with fixed options (values won't change)",{"type":41,"tag":91,"props":912,"children":913},{},[914,915,919],{"type":47,"value":903},{"type":41,"tag":95,"props":916,"children":917},{},[918],{"type":47,"value":448},{"type":47,"value":920}," to a Categories collection (users can add\u002Fedit\u002Fremove categories later)\"",{"type":41,"tag":50,"props":922,"children":923},{},[924,929],{"type":41,"tag":95,"props":925,"children":926},{},[927],{"type":47,"value":928},"Default to relationship",{"type":47,"value":930}," for anything that looks like:",{"type":41,"tag":561,"props":932,"children":933},{},[934,939,944,949],{"type":41,"tag":91,"props":935,"children":936},{},[937],{"type":47,"value":938},"Categories, tags, topics, labels",{"type":41,"tag":91,"props":940,"children":941},{},[942],{"type":47,"value":943},"Authors, assignees, reviewers",{"type":41,"tag":91,"props":945,"children":946},{},[947],{"type":47,"value":948},"Statuses beyond simple draft\u002Fpublished",{"type":41,"tag":91,"props":950,"children":951},{},[952],{"type":47,"value":953},"Types that might expand over time",{"type":41,"tag":50,"props":955,"children":956},{},[957],{"type":41,"tag":95,"props":958,"children":959},{},[960],{"type":47,"value":961},"Use select only for:",{"type":41,"tag":561,"props":963,"children":964},{},[965,970,975],{"type":41,"tag":91,"props":966,"children":967},{},[968],{"type":47,"value":969},"Truly fixed enums (yes\u002Fno, draft\u002Fpublished\u002Farchived)",{"type":41,"tag":91,"props":971,"children":972},{},[973],{"type":47,"value":974},"Options defined by business logic, not content (payment status, priority levels)",{"type":41,"tag":91,"props":976,"children":977},{},[978],{"type":47,"value":979},"Values that would break functionality if changed (role types with code dependencies)",{"type":41,"tag":50,"props":981,"children":982},{},[983],{"type":47,"value":984},"If creating a relationship, remember to add the related collection (Categories, Tags, etc.) to the migration plan.",{"type":41,"tag":56,"props":986,"children":988},{"id":987},"reference-documentation",[989],{"type":47,"value":990},"Reference Documentation",{"type":41,"tag":561,"props":992,"children":993},{},[994],{"type":41,"tag":91,"props":995,"children":996},{},[997,1007],{"type":41,"tag":95,"props":998,"children":999},{},[1000],{"type":41,"tag":1001,"props":1002,"children":1004},"a",{"href":1003},"reference\u002FPAYLOAD-FIELD-REFERENCE.md",[1005],{"type":47,"value":1006},"PAYLOAD-FIELD-REFERENCE.md",{"type":47,"value":1008}," - Complete Payload field type schemas with examples",{"type":41,"tag":56,"props":1010,"children":1012},{"id":1011},"common-pitfalls",[1013],{"type":47,"value":1014},"Common Pitfalls",{"type":41,"tag":1016,"props":1017,"children":1018},"table",{},[1019,1038],{"type":41,"tag":1020,"props":1021,"children":1022},"thead",{},[1023],{"type":41,"tag":1024,"props":1025,"children":1026},"tr",{},[1027,1033],{"type":41,"tag":1028,"props":1029,"children":1030},"th",{},[1031],{"type":47,"value":1032},"Issue",{"type":41,"tag":1028,"props":1034,"children":1035},{},[1036],{"type":47,"value":1037},"How to Handle",{"type":41,"tag":1039,"props":1040,"children":1041},"tbody",{},[1042,1056,1069,1082,1095],{"type":41,"tag":1024,"props":1043,"children":1044},{},[1045,1051],{"type":41,"tag":1046,"props":1047,"children":1048},"td",{},[1049],{"type":47,"value":1050},"User provides partial data",{"type":41,"tag":1046,"props":1052,"children":1053},{},[1054],{"type":47,"value":1055},"Ask for more samples, especially edge cases",{"type":41,"tag":1024,"props":1057,"children":1058},{},[1059,1064],{"type":41,"tag":1046,"props":1060,"children":1061},{},[1062],{"type":47,"value":1063},"Unclear relationships",{"type":41,"tag":1046,"props":1065,"children":1066},{},[1067],{"type":47,"value":1068},"Ask user to describe how content types connect",{"type":41,"tag":1024,"props":1070,"children":1071},{},[1072,1077],{"type":41,"tag":1046,"props":1073,"children":1074},{},[1075],{"type":47,"value":1076},"Rich text ambiguity",{"type":41,"tag":1046,"props":1078,"children":1079},{},[1080],{"type":47,"value":1081},"Clarify: Lexical editor, Slate, or store raw HTML",{"type":41,"tag":1024,"props":1083,"children":1084},{},[1085,1090],{"type":41,"tag":1046,"props":1086,"children":1087},{},[1088],{"type":47,"value":1089},"Missing media collection",{"type":41,"tag":1046,"props":1091,"children":1092},{},[1093],{"type":47,"value":1094},"Always confirm upload collection exists before referencing",{"type":41,"tag":1024,"props":1096,"children":1097},{},[1098,1103],{"type":41,"tag":1046,"props":1099,"children":1100},{},[1101],{"type":47,"value":1102},"Overly complex nested data",{"type":41,"tag":1046,"props":1104,"children":1105},{},[1106],{"type":47,"value":1107},"Consider flattening or using blocks instead of deep groups",{"type":41,"tag":1109,"props":1110,"children":1111},"style",{},[1112],{"type":47,"value":1113},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1115,"total":166},[1116,1121],{"slug":4,"name":4,"fn":5,"description":6,"org":1117,"tags":1118,"stars":20,"repoUrl":21,"updatedAt":22},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1119,1120],{"name":14,"slug":15,"type":16},{"name":18,"slug":19,"type":16},{"slug":8,"name":8,"fn":1122,"description":1123,"org":1124,"tags":1125,"stars":20,"repoUrl":21,"updatedAt":1135},"build and debug Payload CMS projects","Use when working with Payload projects (payload.config.ts, collections, fields, hooks, access control, Payload API). Use when debugging validation errors, security issues, relationship queries, transactions, or hook behavior.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1126,1129,1130,1133],{"name":1127,"slug":1128,"type":16},"Backend","backend",{"name":14,"slug":15,"type":16},{"name":1131,"slug":1132,"type":16},"Database","database",{"name":1134,"slug":147,"type":16},"TypeScript","2026-07-13T05:59:58.08553",{"items":1137,"total":166},[1138,1143],{"slug":4,"name":4,"fn":5,"description":6,"org":1139,"tags":1140,"stars":20,"repoUrl":21,"updatedAt":22},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1141,1142],{"name":14,"slug":15,"type":16},{"name":18,"slug":19,"type":16},{"slug":8,"name":8,"fn":1122,"description":1123,"org":1144,"tags":1145,"stars":20,"repoUrl":21,"updatedAt":1135},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1146,1147,1148,1149],{"name":1127,"slug":1128,"type":16},{"name":14,"slug":15,"type":16},{"name":1131,"slug":1132,"type":16},{"name":1134,"slug":147,"type":16}]