[{"data":1,"prerenderedAt":305},["ShallowReactive",2],{"/reference/collections":3,"/reference/collections-surround":296},{"id":4,"title":5,"body":6,"description":287,"extension":288,"links":289,"meta":290,"navigation":291,"path":292,"seo":293,"stem":294,"__hash__":295},"docs/2.reference/collections.md","Collections",{"type":7,"value":8,"toc":274},"minimark",[9,13,22,27,30,33,75,78,82,85,96,99,108,112,115,126,129,136,140,143,161,168,172,175,182,185,201,205,208,211,225,229,251,255],[10,11,12],"p",{},"Collections let you create sub-groups inside a single object type. They are best for manual curation when you want to organize a type into meaningful sets.",[10,14,15,16,21],{},"If you need to group content across different object types, use ",[17,18,20],"a",{"href":19},"/reference/tags","tags",".",[23,24,26],"h2",{"id":25},"what-collections-are","What collections are",[10,28,29],{},"A collection is a manual group within one object type.",[10,31,32],{},"Examples:",[34,35,36,51,63],"ul",{},[37,38,39,40,44,45,44,48],"li",{},"Meeting object type: ",[41,42,43],"code",{},"1:1s",", ",[41,46,47],{},"Team Retros",[41,49,50],{},"Customer Calls",[37,52,53,54,44,57,44,60],{},"Book object type: ",[41,55,56],{},"Currently Reading",[41,58,59],{},"5-Star Books",[41,61,62],{},"To Revisit",[37,64,65,66,44,69,44,72],{},"Person object type: ",[41,67,68],{},"Advisors",[41,70,71],{},"Close Collaborators",[41,73,74],{},"People to Follow Up With",[10,76,77],{},"You cannot make one collection that mixes books, meetings, and people. Collections are for object types, not individual objects.",[23,79,81],{"id":80},"when-to-use-collections","When to use collections",[10,83,84],{},"Use collections when you want:",[34,86,87,90,93],{},[37,88,89],{},"curated subsets of one object type",[37,91,92],{},"quick access to important groups",[37,94,95],{},"multiple overlapping groups without duplicating content",[10,97,98],{},"Objects can belong to more than one collection.",[10,100,101,102,104,105,21],{},"For example, one Book object can be in both ",[41,103,59],{}," and ",[41,106,107],{},"Books to Recommend",[23,109,111],{"id":110},"collections-vs-folders","Collections vs folders",[10,113,114],{},"Collections are more flexible than folders:",[34,116,117,120,123],{},[37,118,119],{},"objects can be in multiple collections",[37,121,122],{},"collections are groups, not storage containers",[37,124,125],{},"they are not nested folder trees",[10,127,128],{},"If you catch yourself wanting many levels of nested collections, that usually means you should revisit your object-type structure or use queries.",[10,130,131,132,135],{},"For example, if you start building something like ",[41,133,134],{},"Work > Projects > Active > Q3",", that is usually a sign to use properties and queries (or a new object type), not deeper collection nesting.",[23,137,139],{"id":138},"how-to-work-with-collections","How to work with collections",[10,141,142],{},"You can:",[34,144,145,148,151,158],{},[37,146,147],{},"create collections from object dashboards",[37,149,150],{},"add/remove objects manually",[37,152,153,154],{},"update collections in bulk via ",[17,155,157],{"href":156},"/reference/bulk-actions#add-objects-to-or-remove-from-collections","bulk actions",[37,159,160],{},"embed collections on pages for focused views",[10,162,163,164,21],{},"For grouping behavior in views, see ",[17,165,167],{"href":166},"/reference/group-by#group-by-collections","Group by Collections",[23,169,171],{"id":170},"collections-and-queries","Collections and queries",[10,173,174],{},"Collections are manual and curated. Queries are automatic and rule-based.",[10,176,177,178,21],{},"When your grouping rules become consistent and repetitive, move from a manual collection to a ",[17,179,181],{"href":180},"/reference/queries","query",[10,183,184],{},"Example:",[34,186,187,194],{},[37,188,189,190,193],{},"collection: ",[41,191,192],{},"Favorite Articles"," (manual, taste-based curation)",[37,195,196,197,200],{},"query: ",[41,198,199],{},"All articles tagged #Personal Finance created in last 30 days"," (automatic, rule-based retrieval)",[23,202,204],{"id":203},"collections-and-object-type-design","Collections and object-type design",[10,206,207],{},"Collections are often a good first step. But if your collections start representing fundamentally different structures (different properties, workflows, or lifecycles), it is usually time to create a new object type.",[10,209,210],{},"See:",[34,212,213,219],{},[37,214,215],{},[17,216,218],{"href":217},"/tutorials/when-to-create-new-object-type","When to create a new object type",[37,220,221],{},[17,222,224],{"href":223},"/tutorials/custom-content-types","Custom content types",[23,226,228],{"id":227},"faqs","FAQs",[34,230,231],{},[37,232,233,237,240,241,244,245,247,248,250],{},[234,235,236],"strong",{},"I am manually maintaining a collection like \"In Progress\". Should this be a query instead?",[238,239],"br",{},"In many cases, yes. If membership is based on a rule (for example, all projects with ",[41,242,243],{},"Status = In Progress","), a ",[17,246,181],{"href":180}," is usually better than a manual collection.",[238,249],{},"Use collections for hand-picked curation. Use queries when the grouping is rule-based and should update automatically.",[23,252,254],{"id":253},"related-pages","Related pages",[34,256,257,262,268],{},[37,258,259],{},[17,260,261],{"href":19},"Tags",[37,263,264],{},[17,265,267],{"href":266},"/reference/organizational-structures","Organizational structures",[37,269,270],{},[17,271,273],{"href":272},"/tutorials/tags-vs-collections","Tags vs. Collections",{"title":275,"searchDepth":276,"depth":277,"links":278},"",1,2,[279,280,281,282,283,284,285,286],{"id":25,"depth":277,"text":26},{"id":80,"depth":277,"text":81},{"id":110,"depth":277,"text":111},{"id":138,"depth":277,"text":139},{"id":170,"depth":277,"text":171},{"id":203,"depth":277,"text":204},{"id":227,"depth":277,"text":228},{"id":253,"depth":277,"text":254},"Use collections to manually group objects within one object type.","md",null,{},true,"/reference/collections",{"title":5,"description":287},"2.reference/collections","DlwNZt3xS-ys_TDVxaFDAwkhIi-5yRrw3lJQ22FD3XU",[297,301],{"title":298,"path":299,"stem":300,"children":-1},"Calendar Integrations","/reference/calendar-integrations","2.reference/calendar-integrations",{"title":302,"path":303,"stem":304,"children":-1},"Object types","/reference/content-types","2.reference/content-types",1778077527052]