[{"data":1,"prerenderedAt":659},["ShallowReactive",2],{"/reference/properties":3,"/reference/properties-surround":650},{"id":4,"title":5,"body":6,"description":12,"extension":642,"links":643,"meta":644,"navigation":645,"path":646,"seo":647,"stem":648,"__hash__":649},"docs/2.reference/properties.md","Properties",{"type":7,"value":8,"toc":612},"minimark",[9,13,25,32,37,42,45,48,52,56,59,66,69,75,78,87,90,93,104,107,110,113,117,121,130,134,138,141,147,151,155,163,167,171,174,182,185,189,194,197,203,210,217,258,262,266,269,273,277,284,288,292,295,309,313,317,324,328,332,335,342,348,354,358,362,371,374,391,402,408,415,424,428,432,435,441,447,451,469,472,476,479,482,488,492,495,498,504,511,515,522,525,530,537,540,543,549,552,555,559,567,571,574,577,581],[10,11,12],"p",{},"Properties make up the structure of an object type. They define what kind of information each object of that type can hold. A property has a name, a description (optional), an icon, and a type.",[10,14,15,16,20,21,24],{},"Properties are either ",[17,18,19],"code",{},"default"," or ",[17,22,23],{},"normal",".\nDefault properties are system-defined and exist on all object types at a technical level, even if they’re not visible or editable in every type. In custom object types, you can choose to display these default properties in the property list.",[26,27,28],"ul",{},[29,30,31],"li",{},"Normal properties can be added to your custom object types when needed.",[33,34,36],"h2",{"id":35},"title","Title",[10,38,39],{},[17,40,41],{},"default property",[10,43,44],{},"The title of an object. It is a plain text property.",[10,46,47],{},"The title is quite important for search, so giving your content a meaningful title can help you to access it more quickly.",[33,49,51],{"id":50},"aliases","Aliases",[10,53,54],{},[17,55,41],{},[10,57,58],{},"Aliases allow you to refer to the same note with different names. For example Albert Einstein could have an alias of Einstein. When you refer to Einstein in your text, this would count as an unlinked mention of Albert Einstein.",[10,60,61],{},[62,63],"img",{"alt":64,"src":65},"Add alias","/reference/media/search/aliases.png",[10,67,68],{},"Alternatively, if you take notes in multiple languages, you can reference both languages with the aliases.",[10,70,71],{},[62,72],{"alt":73,"src":74},"german alias","/reference/media/search/german-alias.png",[10,76,77],{},"You need to add an alias to each object you'd like to use them with.",[79,80,81,84],"ol",{},[29,82,83],{},"Open your object type settings",[29,85,86],{},"Add the alias property",[10,88,89],{},"This is now an option for all objects of that type. Repeat for each object type as needed.",[10,91,92],{},"To create an alias for an object type:",[79,94,95,98,101],{},[29,96,97],{},"Navigate to the note you wish to add an alias for",[29,99,100],{},"Hover over the title and click 'Add alias'",[29,102,103],{},"Press enter to save.",[10,105,106],{},"You can add multiple aliases by separting the terms with a comma. When you press enter, each individual alias will be saved. You can backspace to remove an alias.",[10,108,109],{},"If you search for an alias of an object, it will get inserted as a link text (instead of the original title).",[10,111,112],{},"Aliases are searchable everywhere search is used (command palette, linking, dashboards).",[33,114,116],{"id":115},"description","Description",[10,118,119],{},[17,120,41],{},[10,122,123,124,129],{},"You can write a description yourself or choose the ",[125,126,128],"a",{"href":127},"./ai-assistant#ai-property-auto-fill","AI autofill"," option.",[33,131,133],{"id":132},"icon","Icon",[10,135,136],{},[17,137,41],{},[10,139,140],{},"Everyone has access to an emoji library, and Pro and Believer users have a full icon library.",[10,142,143],{},[62,144],{"alt":145,"src":146},"icon library","/reference/media/icon-library.png",[33,148,150],{"id":149},"created-at","Created at",[10,152,153],{},[17,154,41],{},[10,156,157,158,162],{},"This is what creates the 'created on this day' view in your ",[125,159,161],{"href":160},"./dates-and-daily-notes#the-calendar","calendar",".",[33,164,166],{"id":165},"tags","Tags",[10,168,169],{},[17,170,41],{},[10,172,173],{},"One of the most important organizational features in Capacities.",[10,175,176,177,181],{},"You can fill tags in manually or have ",[125,178,180],{"href":179},"./ai-assistant#ai-auto-tagging","AI assign tags"," based on your existing set of tags.",[10,183,184],{},"Tags can also have aliases, and those aliases are searchable in tag dropdowns. This helps when you use multiple terms or languages for the same tag.",[33,186,188],{"id":187},"text","Text",[10,190,191],{},[17,192,193],{},"normal property",[10,195,196],{},"Write any text, link to any object, apply any formatting.",[10,198,199],{},[62,200],{"alt":201,"src":202},"Text property with formatting","/reference/media/text-property.png",[10,204,205,206,209],{},"You can toggle on ",[125,207,208],{"href":127},"AI auto-fill"," if you'd like, and add instructions to make output more precise.",[10,211,212,216],{},[213,214,215],"strong",{},"Clickable phone numbers and email addresses:"," You can turn a phone number or email address in a text property into a link that opens the dialler or your default email app.",[79,218,219,233,248],{},[29,220,221,222,225,226,229,230,162],{},"Type the number or address in link form: ",[17,223,224],{},"tel:+\u003Ccountry code>\u003Cnumber>"," (no spaces, e.g. ",[17,227,228],{},"tel:+491234567890",") or ",[17,231,232],{},"mailto:address@example.com",[29,234,235,236,239,240,243,244,247],{},"Select that text and press ",[213,237,238],{},"Insert link"," (",[17,241,242],{},"Cmd + K"," / ",[17,245,246],{},"Ctrl + K",").",[29,249,250,251,20,254,257],{},"In the link dialog, enter the same ",[17,252,253],{},"tel:...",[17,255,256],{},"mailto:..."," string as the URL (or leave it as-is if it’s already filled).",[33,259,261],{"id":260},"cover-image","Cover Image",[10,263,264],{},[17,265,193],{},[10,267,268],{},"Cover images can be uploaded manually, from a URL, from Unsplash or from your existing image object types.",[33,270,272],{"id":271},"number","Number",[10,274,275],{},[17,276,193],{},[10,278,279,280,162],{},"A simple number property with ",[125,281,283],{"href":282},"./number-formatting","various formatting options",[33,285,287],{"id":286},"checkbox","Checkbox",[10,289,290],{},[17,291,193],{},[10,293,294],{},"A simple checkbox property that can either be checked or unchecked.",[10,296,297,303,304,308],{},[125,298,302],{"href":299,"rel":300},"https://capacities.io/pricing",[301],"nofollow","Pro"," users who have enabled ",[125,305,307],{"href":306},"./task-actions","task actions"," are able to use checkboxes to send tasks to their task managers.",[33,310,312],{"id":311},"blocks","Blocks",[10,314,315],{},[17,316,193],{},[10,318,319,320,162],{},"A blocks property that can hold any kind of ",[125,321,323],{"href":322},"/reference/blocks","block-based content",[33,325,327],{"id":326},"datetime","Datetime",[10,329,330],{},[17,331,193],{},[10,333,334],{},"A date property that can be extended to include a time and/or a date range.",[10,336,337,338,341],{},"All date-links will also be shown in the ",[125,339,161],{"href":340},"/reference/dates-and-daily-notes"," on the corresponding day.",[10,343,344],{},[62,345],{"alt":346,"src":347},"new date picker","/reference/media/date-picker.png",[10,349,350],{},[62,351],{"alt":352,"src":353},"Date Reference","/reference/media/date-reference.png",[33,355,357],{"id":356},"label-property","Label Property",[10,359,360],{},[17,361,193],{},[10,363,364,365,20,368,162],{},"Labels are a type of property you can add to your object types. Use them within a single object type to further categorize or filter items. Create a simple dropdown menu with a label property. You can pre-fill the selection from the property settings. They can be ",[213,366,367],{},"single select",[213,369,370],{},"multi-select",[10,372,373],{},"Examples:",[26,375,376,379,382,385,388],{},[29,377,378],{},"Meeting Type (1:1, Sprint, Retrospective)",[29,380,381],{},"Project Status (Scheduled, Completed, Cancelled)",[29,383,384],{},"Book Genre (Fiction, Non-Fiction)",[29,386,387],{},"Reading Status (To Read, Reading, Finished, Abandoned)",[29,389,390],{},"Person Type (Colleague, Friend, Family)",[10,392,393,394,397,398,162],{},"All examples ",[213,395,396],{},"further categorize one object type",". If you want to know more about when to use labels or tags, click ",[125,399,401],{"href":400},"#when-to-use-labels-or-tags","here",[10,403,404],{},[62,405],{"alt":406,"src":407},"label property","/reference/media/label-1.png",[10,409,410,411],{},"If you already have existing tag select properties which would be better suited for labels, you can use the ",[125,412,414],{"href":413},"#changing-the-property-type","change property type function",[10,416,417,418,423],{},"Here's a ",[125,419,422],{"href":420,"rel":421},"https://youtu.be/aICbyg5X9xw",[301],"video"," to learn more.",[33,425,427],{"id":426},"object-select","Object Select",[10,429,430],{},[17,431,193],{},[10,433,434],{},"Object select properties let you link a property to an object type using a dropdown. You select from a predefined object type and can customize the property to support single or multiple selections, two-way linked properties, and fixed sets.",[10,436,437,438,423],{},"Click ",[125,439,401],{"href":440},"./object-properties",[10,442,443],{},[62,444],{"alt":445,"src":446},"Drop Down","/reference/media/object-property/dropdown.png",[33,448,450],{"id":449},"properties-in-basic-types","Properties in Basic Types",[10,452,453,454,458,459,463,464,468],{},"We use these specific properties to add specific data or functionality to our ",[125,455,457],{"href":456},"/reference/content-types#basic-content-types","basic object types",". The file resource property of an ",[125,460,462],{"href":461},"/reference/content-types#image","image"," (or other media types) that holds the reference to the actual file and shows a download button in ",[125,465,467],{"href":466},"/reference/views#table-view","table view"," is an example for that.",[10,470,471],{},"They cannot be edited and custom properties cannot be added.",[33,473,475],{"id":474},"how-to-edit-properties","How to edit properties",[10,477,478],{},"Go to the object settings. There you will find a list of all properties where you can edit, rearrange, and delete them or create new ones by clicking \"Add property\" at the bottom.",[10,480,481],{},"Click on the property you wish to edit, and adapt as needed.",[10,483,484],{},[62,485],{"alt":486,"src":487},"Object settings","/reference/media/property-settings.png",[33,489,491],{"id":490},"changing-the-property-type","Changing the property type",[10,493,494],{},"Some property type changes are supported. Open the property settings and scroll to the 'Change Property Type' section. If a conversion is possible, you will see the options there. If it is not possible, you will be informed by an info box.",[10,496,497],{},"Capacities will create a new property of whatever type you choose, and will match your existing property values as best as possible to the new property.",[10,499,500],{},[62,501],{"alt":502,"src":503},"change property type","/reference/media/change-property-type.png",[505,506,508],"warning",{"title":507},"Tip",[10,509,510],{},"Changing the type of a property can lead to data loss as some values might not be compatible with the new type, which is why the original property is kept for you to review. If you are happy with the results, you can delete the deprecated property.",[33,512,514],{"id":513},"when-to-use-labels-or-tags","When to use labels or tags?",[10,516,517,518,521],{},"Both labels and tags ",[213,519,520],{},"classify or categorize content",", but they serve different purposes.",[10,523,524],{},"In short, labels are for categorizing, and tags are for connecting.",[526,527,529],"h3",{"id":528},"labels","Labels",[10,531,532,533,536],{},"Use a label when you want to ",[213,534,535],{},"categorize content within a single object type",". Labels are properties defined in the object type and apply only to that type.",[10,538,539],{},"For your Meeting object type, use a label like Meeting type, since only meetings need this classification.",[526,541,166],{"id":542},"tags-1",[10,544,545,546,162],{},"Use a tag when you want to ",[213,547,548],{},"connect content across object types by theme or topic",[10,550,551],{},"For example, if you want to connect a project, a meeting, and a page that all relate to “marketing,” use the #marketing tag.",[10,553,554],{},"For something like a Book object, avoid adding a label like Topic because it will only apply to Book objects and you lose insights about content about creativity across your whole space. To track all content about a topic like “Creativity” use a tag instead.",[526,556,558],{"id":557},"tags-in-object-select-properties","Tags in Object Select Properties",[10,560,561,562,566],{},"You can also reference tags inside ",[125,563,565],{"href":564},"#object-select","object select properties",", which lets you build dropdowns that pull from your existing tags. This is useful when you want to enforce consistent tagging within a property.\nIf you just want to apply a tag at the object level, add it under the object’s title.",[33,568,570],{"id":569},"text-or-blocks","Text or Blocks?",[10,572,573],{},"Use the Text property when you want a lightweight plain or rich text field (e.g., a quick comment, or a flexible property in which you can link any object).",[10,575,576],{},"Use the Blocks property when you need full block functionality, such as headings, to-dos, and embedded content.",[33,578,580],{"id":579},"faqs","FAQs",[26,582,583,596],{},[29,584,585,588,591,592,595],{},[213,586,587],{},"I can't see the 'Add Property' button in my object.",[589,590],"br",{},"Please go to ",[17,593,594],{},"Settings > Editor > Hide object type settings outside of settings"," and ensure it's toggled off. Alternatively, you can open your object settings and add your property from there.",[29,597,598,601,603,604,607,608,611],{},[213,599,600],{},"I can't add a Person property",[589,602],{},"If you have a person object type already, please click on ",[17,605,606],{},"Add property > Object Select > Person > Choose the property name",". This will create a property where people are listed as options to choose from in a dropdown menu. You can read more about ",[125,609,610],{"href":564},"object selects"," here.",{"title":613,"searchDepth":614,"depth":615,"links":616},"",1,2,[617,618,619,620,621,622,623,624,625,626,627,628,629,630,631,632,633,634,640,641],{"id":35,"depth":615,"text":36},{"id":50,"depth":615,"text":51},{"id":115,"depth":615,"text":116},{"id":132,"depth":615,"text":133},{"id":149,"depth":615,"text":150},{"id":165,"depth":615,"text":166},{"id":187,"depth":615,"text":188},{"id":260,"depth":615,"text":261},{"id":271,"depth":615,"text":272},{"id":286,"depth":615,"text":287},{"id":311,"depth":615,"text":312},{"id":326,"depth":615,"text":327},{"id":356,"depth":615,"text":357},{"id":426,"depth":615,"text":427},{"id":449,"depth":615,"text":450},{"id":474,"depth":615,"text":475},{"id":490,"depth":615,"text":491},{"id":513,"depth":615,"text":514,"children":635},[636,638,639],{"id":528,"depth":637,"text":529},3,{"id":542,"depth":637,"text":166},{"id":557,"depth":637,"text":558},{"id":569,"depth":615,"text":570},{"id":579,"depth":615,"text":580},"md",null,{},true,"/reference/properties",{"title":5,"description":12},"2.reference/properties","S1jaS8PJUSOZd0VtPCzHlKGUmq8ANW6zIDapkEOFR-I",[651,655],{"title":652,"path":653,"stem":654,"children":-1},"Page layouts","/reference/page-layouts","2.reference/page-layouts",{"title":656,"path":657,"stem":658,"children":-1},"Queries","/reference/queries","2.reference/queries",1775810836466]