[{"data":1,"prerenderedAt":1804},["ShallowReactive",2],{"docs-sidebar-source":3,"content-query-1UpHCjuwXD":301},[4,8,11,14,17,21,25,29,32,35,39,43,47,51,55,59,63,67,70,73,77,81,85,88,91,94,98,102,106,110,114,117,120,124,128,132,136,140,144,148,151,154,157,160,163,166,169,172,175,178,181,184,187,190,193,196,199,202,205,208,211,214,217,220,223,226,229,232,235,238,241,244,247,250,253,256,259,262,265,268,271,274,277,280,283,286,289,292,295,298],{"_path":5,"title":6,"order":7},"/docs/getting-started","Getting Started",1,{"_path":9,"title":10,"order":7},"/docs/self-hosting/all-in-one","All-in-One Setup",{"_path":12,"title":13,"order":7},"/docs/api/server","Server API",{"_path":15,"title":16,"order":7},"/docs/views/grid","Grid View",{"_path":18,"title":19,"order":20},"/docs/core-concepts","Core Concepts",10,{"_path":22,"title":23,"order":24},"/docs/crdt","What is a CRDT?",11,{"_path":26,"title":27,"order":28},"/docs/self-hosting/separate-containers","Separate Containers Setup",2,{"_path":30,"title":31,"order":28},"/docs/api/client-http","Client HTTP API",{"_path":33,"title":34,"order":28},"/docs/views/table","Table View",{"_path":36,"title":37,"order":38},"/docs/interface-overview","Interface Overview",20,{"_path":40,"title":41,"order":42},"/docs/global-search","Global Search",22,{"_path":44,"title":45,"order":46},"/docs/filters","Filters",24,{"_path":48,"title":49,"order":50},"/docs/sorting","Sorting",25,{"_path":52,"title":53,"order":54},"/docs/tagging-and-selection","Tagging & Selection",26,{"_path":56,"title":57,"order":58},"/docs/properties","Properties",27,{"_path":60,"title":61,"order":62},"/docs/quick-view","Quick View",28,{"_path":64,"title":65,"order":66},"/docs/self-hosting/updating","Updating Heaper",3,{"_path":68,"title":69,"order":66},"/docs/api/cli","CLI",{"_path":71,"title":72,"order":66},"/docs/views/list","List View",{"_path":74,"title":75,"order":76},"/docs/block-actions","Block Actions",30,{"_path":78,"title":79,"order":80},"/docs/deleting-blocks","Deleting Blocks & Trash",32,{"_path":82,"title":83,"order":84},"/docs/self-hosting/remote-access-tailscale","Remote Access with Tailscale",4,{"_path":86,"title":87,"order":84},"/docs/self-hosting","Self-Hosting",{"_path":89,"title":90,"order":84},"/docs/api/agents-mcp","Agent and MCP Access",{"_path":92,"title":93,"order":84},"/docs/views/tasks","Tasks View",{"_path":95,"title":96,"order":97},"/docs/managing-heaps","Managing Heaps",40,{"_path":99,"title":100,"order":101},"/docs/file-scanning","File Scanning & Importing",42,{"_path":103,"title":104,"order":105},"/docs/storage-management","Storage Management",44,{"_path":107,"title":108,"order":109},"/docs/daily-notes","Daily Notes & Calendar",46,{"_path":111,"title":112,"order":113},"/docs/api/cli-reference","CLI Reference",5,{"_path":115,"title":116,"order":113},"/docs/api","API",{"_path":118,"title":119,"order":113},"/docs/views/kanban-board","Board View",{"_path":121,"title":122,"order":123},"/docs/views/calendar","Calendar View",6,{"_path":125,"title":126,"order":127},"/docs/views","Views",60,{"_path":129,"title":130,"order":131},"/docs/views/graph","Graph View",7,{"_path":133,"title":134,"order":135},"/docs/authentication","Authentication & User Management",70,{"_path":137,"title":138,"order":139},"/docs/licenses-privacy","Licenses & Privacy",72,{"_path":141,"title":142,"order":143},"/docs/faq","FAQ",80,{"_path":145,"title":146,"order":147},"/docs/changelog","Changelog",99,{"_path":149,"title":150},"/docs/changelog/v16.16.25","v16.16.25",{"_path":152,"title":153},"/docs/changelog/v16.16.39","v16.16.39",{"_path":155,"title":156},"/docs/changelog/v16.10.0","v16.10.0",{"_path":158,"title":159},"/docs/changelog/v16.17.8","v16.17.8",{"_path":161,"title":162},"/docs/changelog/v16.11.0","v16.11.0",{"_path":164,"title":165},"/docs/changelog/v16.16.2","v16.16.2",{"_path":167,"title":168},"/docs/changelog/v16.16.11","v16.16.11",{"_path":170,"title":171},"/docs/changelog/v16.16.27","v16.16.27",{"_path":173,"title":174},"/docs/changelog/v16.16.22","v16.16.22",{"_path":176,"title":177},"/docs/changelog/v16.16.14","v16.16.14",{"_path":179,"title":180},"/docs/changelog/v16.16.6","v16.16.6",{"_path":182,"title":183},"/docs/changelog/v16.16.36","v16.16.36",{"_path":185,"title":186},"/docs/changelog/v16.16.33","v16.16.33",{"_path":188,"title":189},"/docs/changelog/v16.19","v16.19",{"_path":191,"title":192},"/docs/changelog/v16.16.16","v16.16.16",{"_path":194,"title":195},"/docs/changelog/v16.16.8","v16.16.8",{"_path":197,"title":198},"/docs/changelog/v16.16.40","v16.16.40",{"_path":200,"title":201},"/docs/changelog/v16.16.0","v16.16.0",{"_path":203,"title":204},"/docs/changelog/v16.16.32","v16.16.32",{"_path":206,"title":207},"/docs/changelog/v16.16.28","v16.16.28",{"_path":209,"title":210},"/docs/changelog/v16.16.15","v16.16.15",{"_path":212,"title":213},"/docs/changelog/v16.16.9","v16.16.9",{"_path":215,"title":216},"/docs/changelog/v16.16.38","v16.16.38",{"_path":218,"title":219},"/docs/changelog/v16.6.0","v16.6.0",{"_path":221,"title":222},"/docs/changelog/v16.16.7","v16.16.7",{"_path":224,"title":225},"/docs/changelog/v16.9.0","v16.9.0",{"_path":227,"title":228},"/docs/changelog/v16.8.0","v16.8.0",{"_path":230,"title":231},"/docs/changelog/v16.16.17","v16.16.17",{"_path":233,"title":234},"/docs/changelog/v16.16.12","v16.16.12",{"_path":236,"title":237},"/docs/changelog/v16.7.0","v16.7.0",{"_path":239,"title":240},"/docs/changelog/v16.16.20","v16.16.20",{"_path":242,"title":243},"/docs/changelog/v16.16.23","v16.16.23",{"_path":245,"title":246},"/docs/changelog/v16.16.41","v16.16.41",{"_path":248,"title":249},"/docs/changelog/v16.16.30","v16.16.30",{"_path":251,"title":252},"/docs/changelog/v16.16.34","v16.16.34",{"_path":254,"title":255},"/docs/changelog/v16.16.4","v16.16.4",{"_path":257,"title":258},"/docs/changelog/v16.16.19","v16.16.19",{"_path":260,"title":261},"/docs/changelog/v16.16.43","v16.16.43",{"_path":263,"title":264},"/docs/changelog/v16.16.13","v16.16.13",{"_path":266,"title":267},"/docs/changelog/v16.16.26","v16.16.26",{"_path":269,"title":270},"/docs/changelog/v16.16.18","v16.16.18",{"_path":272,"title":273},"/docs/changelog/v16.16.10","v16.16.10",{"_path":275,"title":276},"/docs/changelog/v16.16.35","v16.16.35",{"_path":278,"title":279},"/docs/changelog/v16.16.21","v16.16.21",{"_path":281,"title":282},"/docs/changelog/v16.16.37","v16.16.37",{"_path":284,"title":285},"/docs/changelog/v16.16.31","v16.16.31",{"_path":287,"title":288},"/docs/changelog/v16.16.3","v16.16.3",{"_path":290,"title":291},"/docs/changelog/v16.16.29","v16.16.29",{"_path":293,"title":294},"/docs/changelog/v16.16.24","v16.16.24",{"_path":296,"title":297},"/docs/changelog/v16.16.1","v16.16.1",{"_path":299,"title":300},"/docs/changelog/v16.16.5","v16.16.5",{"_path":56,"_dir":302,"_draft":303,"_partial":303,"_locale":304,"title":57,"description":305,"order":58,"body":306,"_type":1798,"_id":1799,"_source":1800,"_file":1801,"_stem":1802,"_extension":1803},"docs",false,"","Add structured information to blocks with reusable fields for text, numbers, dates, choices, and references",{"type":307,"children":308,"toc":1772},"root",[309,317,323,336,343,350,364,375,381,449,461,467,472,653,662,668,673,706,719,725,730,846,866,872,1039,1047,1053,1059,1078,1101,1106,1112,1117,1122,1145,1150,1156,1175,1180,1208,1220,1225,1231,1244,1250,1296,1322,1327,1335,1341,1346,1369,1377,1410,1427,1435,1440,1446,1451,1512,1517,1523,1596,1607,1613,1653,1658,1664,1669,1711,1723,1728,1734,1739,1744],{"type":310,"tag":311,"props":312,"children":314},"element","h1",{"id":313},"properties",[315],{"type":316,"value":57},"text",{"type":310,"tag":318,"props":319,"children":320},"p",{},[321],{"type":316,"value":322},"Properties add structured information to any block. A book can have an author, page count, reading status, rating, and finish date. The same properties can be reused on notes, files, tasks, and other blocks throughout your heap.",{"type":310,"tag":318,"props":324,"children":325},{},[326,328,334],{"type":316,"value":327},"This guide builds a fictional book called ",{"type":310,"tag":329,"props":330,"children":331},"strong",{},[332],{"type":316,"value":333},"The Glass Archive",{"type":316,"value":335},". It uses one field from each property family so you can see the differences.",{"type":310,"tag":337,"props":338,"children":340},"h2",{"id":339},"add-your-first-properties",[341],{"type":316,"value":342},"Add your first properties",{"type":310,"tag":344,"props":345,"children":347},"h3",{"id":346},"_1-open-properties",[348],{"type":316,"value":349},"1. Open Properties",{"type":310,"tag":318,"props":351,"children":352},{},[353,355,362],{"type":316,"value":354},"Open a document and type ",{"type":310,"tag":356,"props":357,"children":359},"code",{"className":358},[],[360],{"type":316,"value":361},"---",{"type":316,"value":363}," in its first empty paragraph. Heaper removes the three characters and opens the Properties panel above the document.",{"type":310,"tag":318,"props":365,"children":366},{},[367,369,373],{"type":316,"value":368},"You can also open the selection sidebar, expand ",{"type":310,"tag":329,"props":370,"children":371},{},[372],{"type":316,"value":57},{"type":316,"value":374},", and edit the current block or every selected block from there.",{"type":310,"tag":344,"props":376,"children":378},{"id":377},"_2-create-an-isbn-property",[379],{"type":316,"value":380},"2. Create an ISBN property",{"type":310,"tag":382,"props":383,"children":384},"ol",{},[385,398,410,427,438],{"type":310,"tag":386,"props":387,"children":388},"li",{},[389,391,396],{"type":316,"value":390},"Select ",{"type":310,"tag":329,"props":392,"children":393},{},[394],{"type":316,"value":395},"Add property",{"type":316,"value":397},".",{"type":310,"tag":386,"props":399,"children":400},{},[401,403,409],{"type":316,"value":402},"Enter ",{"type":310,"tag":356,"props":404,"children":406},{"className":405},[],[407],{"type":316,"value":408},"ISBN",{"type":316,"value":397},{"type":310,"tag":386,"props":411,"children":412},{},[413,415,420,422,426],{"type":316,"value":414},"Open the type picker and choose ",{"type":310,"tag":329,"props":416,"children":417},{},[418],{"type":316,"value":419},"Text",{"type":316,"value":421},", then ",{"type":310,"tag":329,"props":423,"children":424},{},[425],{"type":316,"value":419},{"type":316,"value":397},{"type":310,"tag":386,"props":428,"children":429},{},[430,431,436],{"type":316,"value":390},{"type":310,"tag":329,"props":432,"children":433},{},[434],{"type":316,"value":435},"Create \"ISBN\"",{"type":316,"value":437}," to create the reusable property.",{"type":310,"tag":386,"props":439,"children":440},{},[441,442,448],{"type":316,"value":402},{"type":310,"tag":356,"props":443,"children":445},{"className":444},[],[446],{"type":316,"value":447},"978-1-23456-789-7",{"type":316,"value":397},{"type":310,"tag":318,"props":450,"children":451},{},[452,454,459],{"type":316,"value":453},"Reusable is the default. Use it when the same ISBN field belongs on every book. Select ",{"type":310,"tag":329,"props":455,"children":456},{},[457],{"type":316,"value":458},"Create as inline",{"type":316,"value":460}," only when the field should exist on this block alone.",{"type":310,"tag":344,"props":462,"children":464},{"id":463},"_3-add-the-other-core-fields",[465],{"type":316,"value":466},"3. Add the other core fields",{"type":310,"tag":318,"props":468,"children":469},{},[470],{"type":316,"value":471},"Repeat the same flow for the remaining fields:",{"type":310,"tag":473,"props":474,"children":475},"table",{},[476,505],{"type":310,"tag":477,"props":478,"children":479},"thead",{},[480],{"type":310,"tag":481,"props":482,"children":483},"tr",{},[484,490,495,500],{"type":310,"tag":485,"props":486,"children":487},"th",{},[488],{"type":316,"value":489},"Field",{"type":310,"tag":485,"props":491,"children":492},{},[493],{"type":316,"value":494},"Exact picker choice",{"type":310,"tag":485,"props":496,"children":497},{},[498],{"type":316,"value":499},"Example value",{"type":310,"tag":485,"props":501,"children":502},{},[503],{"type":316,"value":504},"What it stores",{"type":310,"tag":506,"props":507,"children":508},"tbody",{},[509,542,569,596,626],{"type":310,"tag":481,"props":510,"children":511},{},[512,517,522,530],{"type":310,"tag":513,"props":514,"children":515},"td",{},[516],{"type":316,"value":408},{"type":310,"tag":513,"props":518,"children":519},{},[520],{"type":316,"value":521},"Text → Text",{"type":310,"tag":513,"props":523,"children":524},{},[525],{"type":310,"tag":356,"props":526,"children":528},{"className":527},[],[529],{"type":316,"value":447},{"type":310,"tag":513,"props":531,"children":532},{},[533,535,541],{"type":316,"value":534},"Free text. It keeps hyphens, leading zeroes, and letters such as ",{"type":310,"tag":356,"props":536,"children":538},{"className":537},[],[539],{"type":316,"value":540},"X",{"type":316,"value":397},{"type":310,"tag":481,"props":543,"children":544},{},[545,550,555,564],{"type":310,"tag":513,"props":546,"children":547},{},[548],{"type":316,"value":549},"Pages",{"type":310,"tag":513,"props":551,"children":552},{},[553],{"type":316,"value":554},"Number → Number",{"type":310,"tag":513,"props":556,"children":557},{},[558],{"type":310,"tag":356,"props":559,"children":561},{"className":560},[],[562],{"type":316,"value":563},"416",{"type":310,"tag":513,"props":565,"children":566},{},[567],{"type":316,"value":568},"A page count that sorts and filters as a number.",{"type":310,"tag":481,"props":570,"children":571},{},[572,577,582,591],{"type":310,"tag":513,"props":573,"children":574},{},[575],{"type":316,"value":576},"Finished on",{"type":310,"tag":513,"props":578,"children":579},{},[580],{"type":316,"value":581},"Date → Date",{"type":310,"tag":513,"props":583,"children":584},{},[585],{"type":310,"tag":356,"props":586,"children":588},{"className":587},[],[589],{"type":316,"value":590},"24 July 2026",{"type":310,"tag":513,"props":592,"children":593},{},[594],{"type":316,"value":595},"One calendar date. Leave it empty until the book is finished.",{"type":310,"tag":481,"props":597,"children":598},{},[599,604,609,614],{"type":310,"tag":513,"props":600,"children":601},{},[602],{"type":316,"value":603},"Favorite",{"type":310,"tag":513,"props":605,"children":606},{},[607],{"type":316,"value":608},"Choice → Checkbox",{"type":310,"tag":513,"props":610,"children":611},{},[612],{"type":316,"value":613},"Yes or No",{"type":310,"tag":513,"props":615,"children":616},{},[617,619,624],{"type":316,"value":618},"Both the Yes and No states. If you only mark favorites, use a ",{"type":310,"tag":356,"props":620,"children":622},{"className":621},[],[623],{"type":316,"value":603},{"type":316,"value":625}," tag instead.",{"type":310,"tag":481,"props":627,"children":628},{},[629,634,639,648],{"type":310,"tag":513,"props":630,"children":631},{},[632],{"type":316,"value":633},"Author",{"type":310,"tag":513,"props":635,"children":636},{},[637],{"type":316,"value":638},"Reference → Reference",{"type":310,"tag":513,"props":640,"children":641},{},[642],{"type":310,"tag":356,"props":643,"children":645},{"className":644},[],[646],{"type":316,"value":647},"Mara Voss",{"type":310,"tag":513,"props":649,"children":650},{},[651],{"type":316,"value":652},"A link to the author's block. Allow multiple references for books with several authors. Person is for heap members.",{"type":310,"tag":318,"props":654,"children":655},{},[656],{"type":310,"tag":657,"props":658,"children":661},"img",{"alt":659,"src":660},"The Properties panel for The Glass Archive, showing text, number, date, checkbox, and block-reference fields","/assets/docs/properties/properties-panel.webp",[],{"type":310,"tag":337,"props":663,"children":665},{"id":664},"use-tags-for-one-way-states",[666],{"type":316,"value":667},"Use tags for one-way states",{"type":310,"tag":318,"props":669,"children":670},{},[671],{"type":316,"value":672},"Use a tag when you only need to mark that something is on:",{"type":310,"tag":674,"props":675,"children":676},"ul",{},[677,689,701],{"type":310,"tag":386,"props":678,"children":679},{},[680,682,687],{"type":316,"value":681},"Add a ",{"type":310,"tag":356,"props":683,"children":685},{"className":684},[],[686],{"type":316,"value":603},{"type":316,"value":688}," tag to favorite books.",{"type":310,"tag":386,"props":690,"children":691},{},[692,693,699],{"type":316,"value":681},{"type":310,"tag":356,"props":694,"children":696},{"className":695},[],[697],{"type":316,"value":698},"Needs review",{"type":316,"value":700}," tag to items that need review.",{"type":310,"tag":386,"props":702,"children":703},{},[704],{"type":316,"value":705},"No tag means the state is not on.",{"type":310,"tag":318,"props":707,"children":708},{},[709,711,717],{"type":316,"value":710},"Use a Checkbox property only when both Yes and No are useful data. For example, use a ",{"type":310,"tag":356,"props":712,"children":714},{"className":713},[],[715],{"type":316,"value":716},"Favorite book",{"type":316,"value":718}," checkbox when you must filter explicitly for books marked No.",{"type":310,"tag":337,"props":720,"children":722},{"id":721},"property-types",[723],{"type":316,"value":724},"Property types",{"type":310,"tag":318,"props":726,"children":727},{},[728],{"type":316,"value":729},"The type picker groups properties into five families:",{"type":310,"tag":473,"props":731,"children":732},{},[733,754],{"type":310,"tag":477,"props":734,"children":735},{},[736],{"type":310,"tag":481,"props":737,"children":738},{},[739,744,749],{"type":310,"tag":485,"props":740,"children":741},{},[742],{"type":316,"value":743},"Family",{"type":310,"tag":485,"props":745,"children":746},{},[747],{"type":316,"value":748},"Use it for",{"type":310,"tag":485,"props":750,"children":751},{},[752],{"type":316,"value":753},"Common types",{"type":310,"tag":506,"props":755,"children":756},{},[757,774,792,810,828],{"type":310,"tag":481,"props":758,"children":759},{},[760,764,769],{"type":310,"tag":513,"props":761,"children":762},{},[763],{"type":316,"value":419},{"type":310,"tag":513,"props":765,"children":766},{},[767],{"type":316,"value":768},"Free text, names, codes, and identifiers",{"type":310,"tag":513,"props":770,"children":771},{},[772],{"type":316,"value":773},"Text, Email, Phone, URL",{"type":310,"tag":481,"props":775,"children":776},{},[777,782,787],{"type":310,"tag":513,"props":778,"children":779},{},[780],{"type":316,"value":781},"Number",{"type":310,"tag":513,"props":783,"children":784},{},[785],{"type":316,"value":786},"Values that sort, compare, or calculate numerically",{"type":310,"tag":513,"props":788,"children":789},{},[790],{"type":316,"value":791},"Number, Money, Percent, Rating, measurements",{"type":310,"tag":481,"props":793,"children":794},{},[795,800,805],{"type":310,"tag":513,"props":796,"children":797},{},[798],{"type":316,"value":799},"Date",{"type":310,"tag":513,"props":801,"children":802},{},[803],{"type":316,"value":804},"Calendar dates and time-based values",{"type":310,"tag":513,"props":806,"children":807},{},[808],{"type":316,"value":809},"Date, optional time, date ranges, reminders, recurrence",{"type":310,"tag":481,"props":811,"children":812},{},[813,818,823],{"type":310,"tag":513,"props":814,"children":815},{},[816],{"type":316,"value":817},"Choice",{"type":310,"tag":513,"props":819,"children":820},{},[821],{"type":316,"value":822},"Values selected from a fixed set",{"type":310,"tag":513,"props":824,"children":825},{},[826],{"type":316,"value":827},"Checkbox, Choice, Status",{"type":310,"tag":481,"props":829,"children":830},{},[831,836,841],{"type":310,"tag":513,"props":832,"children":833},{},[834],{"type":316,"value":835},"Reference",{"type":310,"tag":513,"props":837,"children":838},{},[839],{"type":316,"value":840},"Links to other blocks",{"type":310,"tag":513,"props":842,"children":843},{},[844],{"type":316,"value":845},"Reference, Person, Files & media, Place",{"type":310,"tag":318,"props":847,"children":848},{},[849,851,857,859,865],{"type":316,"value":850},"The type controls the editor, formatting, sorting, filtering, and which apps can use the value. Calendar reads Date properties. Number properties sort ",{"type":310,"tag":356,"props":852,"children":854},{"className":853},[],[855],{"type":316,"value":856},"20",{"type":316,"value":858}," before ",{"type":310,"tag":356,"props":860,"children":862},{"className":861},[],[863],{"type":316,"value":864},"100",{"type":316,"value":397},{"type":310,"tag":344,"props":867,"children":869},{"id":868},"useful-additions-to-the-book-example",[870],{"type":316,"value":871},"Useful additions to the Book example",{"type":310,"tag":473,"props":873,"children":874},{},[875,893],{"type":310,"tag":477,"props":876,"children":877},{},[878],{"type":310,"tag":481,"props":879,"children":880},{},[881,885,889],{"type":310,"tag":485,"props":882,"children":883},{},[884],{"type":316,"value":489},{"type":310,"tag":485,"props":886,"children":887},{},[888],{"type":316,"value":494},{"type":310,"tag":485,"props":890,"children":891},{},[892],{"type":316,"value":504},{"type":310,"tag":506,"props":894,"children":895},{},[896,914,932,950,968,986,1004,1022],{"type":310,"tag":481,"props":897,"children":898},{},[899,904,909],{"type":310,"tag":513,"props":900,"children":901},{},[902],{"type":316,"value":903},"Format",{"type":310,"tag":513,"props":905,"children":906},{},[907],{"type":316,"value":908},"Choice → Choice",{"type":310,"tag":513,"props":910,"children":911},{},[912],{"type":316,"value":913},"One option such as Hardcover, Paperback, Ebook, or Audiobook.",{"type":310,"tag":481,"props":915,"children":916},{},[917,922,927],{"type":310,"tag":513,"props":918,"children":919},{},[920],{"type":316,"value":921},"Reading status",{"type":310,"tag":513,"props":923,"children":924},{},[925],{"type":316,"value":926},"Choice → Status",{"type":310,"tag":513,"props":928,"children":929},{},[930],{"type":316,"value":931},"A workflow state such as Want to read, Reading, or Finished.",{"type":310,"tag":481,"props":933,"children":934},{},[935,940,945],{"type":310,"tag":513,"props":936,"children":937},{},[938],{"type":316,"value":939},"Rating",{"type":310,"tag":513,"props":941,"children":942},{},[943],{"type":316,"value":944},"Number → Rating",{"type":310,"tag":513,"props":946,"children":947},{},[948],{"type":316,"value":949},"A number displayed as stars, dots, or a numeric score.",{"type":310,"tag":481,"props":951,"children":952},{},[953,958,963],{"type":310,"tag":513,"props":954,"children":955},{},[956],{"type":316,"value":957},"Reading progress",{"type":310,"tag":513,"props":959,"children":960},{},[961],{"type":316,"value":962},"Number → Percent",{"type":310,"tag":513,"props":964,"children":965},{},[966],{"type":316,"value":967},"A number displayed as a percentage.",{"type":310,"tag":481,"props":969,"children":970},{},[971,976,981],{"type":310,"tag":513,"props":972,"children":973},{},[974],{"type":316,"value":975},"Price paid",{"type":310,"tag":513,"props":977,"children":978},{},[979],{"type":316,"value":980},"Number → Money",{"type":310,"tag":513,"props":982,"children":983},{},[984],{"type":316,"value":985},"A number displayed with a currency.",{"type":310,"tag":481,"props":987,"children":988},{},[989,994,999],{"type":310,"tag":513,"props":990,"children":991},{},[992],{"type":316,"value":993},"Store link",{"type":310,"tag":513,"props":995,"children":996},{},[997],{"type":316,"value":998},"Text → URL",{"type":310,"tag":513,"props":1000,"children":1001},{},[1002],{"type":316,"value":1003},"A web address.",{"type":310,"tag":481,"props":1005,"children":1006},{},[1007,1012,1017],{"type":310,"tag":513,"props":1008,"children":1009},{},[1010],{"type":316,"value":1011},"Cover",{"type":310,"tag":513,"props":1013,"children":1014},{},[1015],{"type":316,"value":1016},"Reference → Files & media",{"type":310,"tag":513,"props":1018,"children":1019},{},[1020],{"type":316,"value":1021},"A link to an image or file block.",{"type":310,"tag":481,"props":1023,"children":1024},{},[1025,1030,1034],{"type":310,"tag":513,"props":1026,"children":1027},{},[1028],{"type":316,"value":1029},"Series",{"type":310,"tag":513,"props":1031,"children":1032},{},[1033],{"type":316,"value":638},{"type":310,"tag":513,"props":1035,"children":1036},{},[1037],{"type":316,"value":1038},"A link to the series block.",{"type":310,"tag":318,"props":1040,"children":1041},{},[1042],{"type":310,"tag":657,"props":1043,"children":1046},{"alt":1044,"src":1045},"The reusable Rating property configured with a five-star display","/assets/docs/properties/property-definition.webp",[],{"type":310,"tag":337,"props":1048,"children":1050},{"id":1049},"reusable-and-inline-properties",[1051],{"type":316,"value":1052},"Reusable and inline properties",{"type":310,"tag":344,"props":1054,"children":1056},{"id":1055},"reusable-properties",[1057],{"type":316,"value":1058},"Reusable properties",{"type":310,"tag":318,"props":1060,"children":1061},{},[1062,1064,1069,1071,1076],{"type":316,"value":1063},"A reusable property is a normal block configured to act as a field. Reuse the same ",{"type":310,"tag":356,"props":1065,"children":1067},{"className":1066},[],[1068],{"type":316,"value":633},{"type":316,"value":1070}," or ",{"type":310,"tag":356,"props":1072,"children":1074},{"className":1073},[],[1075],{"type":316,"value":939},{"type":316,"value":1077}," property everywhere that concept means the same thing.",{"type":310,"tag":674,"props":1079,"children":1080},{},[1081,1086,1091,1096],{"type":310,"tag":386,"props":1082,"children":1083},{},[1084],{"type":316,"value":1085},"Search for it by name when adding a property to another block.",{"type":310,"tag":386,"props":1087,"children":1088},{},[1089],{"type":316,"value":1090},"Open the property block to document, tag, or inspect it like any other block.",{"type":310,"tag":386,"props":1092,"children":1093},{},[1094],{"type":316,"value":1095},"Rename or reconfigure it once to update how it appears everywhere.",{"type":310,"tag":386,"props":1097,"children":1098},{},[1099],{"type":316,"value":1100},"Use its identity in filters, views, and app mappings.",{"type":310,"tag":318,"props":1102,"children":1103},{},[1104],{"type":316,"value":1105},"Choose reusable for fields that should be consistent across several blocks.",{"type":310,"tag":344,"props":1107,"children":1109},{"id":1108},"inline-properties",[1110],{"type":316,"value":1111},"Inline properties",{"type":310,"tag":318,"props":1113,"children":1114},{},[1115],{"type":316,"value":1116},"An inline property belongs only to the block where you create it. It is useful for a quick note or a field you are not ready to reuse.",{"type":310,"tag":318,"props":1118,"children":1119},{},[1120],{"type":316,"value":1121},"To convert one later:",{"type":310,"tag":382,"props":1123,"children":1124},{},[1125,1130,1140],{"type":310,"tag":386,"props":1126,"children":1127},{},[1128],{"type":316,"value":1129},"Select the inline property name.",{"type":310,"tag":386,"props":1131,"children":1132},{},[1133,1134,1139],{"type":316,"value":390},{"type":310,"tag":329,"props":1135,"children":1136},{},[1137],{"type":316,"value":1138},"Make reusable",{"type":316,"value":397},{"type":310,"tag":386,"props":1141,"children":1142},{},[1143],{"type":316,"value":1144},"Heaper creates a property block and moves the current value to it.",{"type":310,"tag":318,"props":1146,"children":1147},{},[1148],{"type":316,"value":1149},"Changing an inline property's name or type affects only that field. Changing a reusable definition affects every block that uses it.",{"type":310,"tag":337,"props":1151,"children":1153},{"id":1152},"configure-a-reusable-property",[1154],{"type":316,"value":1155},"Configure a reusable property",{"type":310,"tag":318,"props":1157,"children":1158},{},[1159,1161,1166,1168,1173],{"type":316,"value":1160},"Select a reusable property name and choose ",{"type":310,"tag":329,"props":1162,"children":1163},{},[1164],{"type":316,"value":1165},"Open property block",{"type":316,"value":1167},". Its Properties panel contains ",{"type":310,"tag":329,"props":1169,"children":1170},{},[1171],{"type":316,"value":1172},"Property type",{"type":316,"value":1174},". Open that row to configure the field.",{"type":310,"tag":318,"props":1176,"children":1177},{},[1178],{"type":316,"value":1179},"Each type has its own settings:",{"type":310,"tag":674,"props":1181,"children":1182},{},[1183,1188,1193,1198,1203],{"type":310,"tag":386,"props":1184,"children":1185},{},[1186],{"type":316,"value":1187},"Date: time, date ranges, timezone, reminders, recurrence, and display format.",{"type":310,"tag":386,"props":1189,"children":1190},{},[1191],{"type":316,"value":1192},"Number: money, percentages, ratings, measurements, limits, precision, and progress displays.",{"type":310,"tag":386,"props":1194,"children":1195},{},[1196],{"type":316,"value":1197},"Choice: single or multiple selection, option colors, and option sorting.",{"type":310,"tag":386,"props":1199,"children":1200},{},[1201],{"type":316,"value":1202},"Reference: one linked block or several linked blocks.",{"type":310,"tag":386,"props":1204,"children":1205},{},[1206],{"type":316,"value":1207},"Checkbox: custom labels for the checked and unchecked states.",{"type":310,"tag":318,"props":1209,"children":1210},{},[1211,1213,1218],{"type":316,"value":1212},"For ",{"type":310,"tag":356,"props":1214,"children":1216},{"className":1215},[],[1217],{"type":316,"value":921},{"type":316,"value":1219},", rename the default Status options to match your workflow, for example Want to read, Reading, and Finished.",{"type":310,"tag":318,"props":1221,"children":1222},{},[1223],{"type":316,"value":1224},"Save the property to apply the definition everywhere it is reused.",{"type":310,"tag":337,"props":1226,"children":1228},{"id":1227},"let-a-tag-provide-properties",[1229],{"type":316,"value":1230},"Let a tag provide properties",{"type":310,"tag":318,"props":1232,"children":1233},{},[1234,1236,1242],{"type":316,"value":1235},"A tag can offer a consistent set of properties to every block tagged with it. This lets the ",{"type":310,"tag":356,"props":1237,"children":1239},{"className":1238},[],[1240],{"type":316,"value":1241},"Book",{"type":316,"value":1243}," tag describe what information books normally have.",{"type":310,"tag":344,"props":1245,"children":1247},{"id":1246},"configure-the-book-tag",[1248],{"type":316,"value":1249},"Configure the Book tag",{"type":310,"tag":382,"props":1251,"children":1252},{},[1253,1265,1275,1291],{"type":310,"tag":386,"props":1254,"children":1255},{},[1256,1258,1263],{"type":316,"value":1257},"Open the ",{"type":310,"tag":356,"props":1259,"children":1261},{"className":1260},[],[1262],{"type":316,"value":1241},{"type":316,"value":1264}," block.",{"type":310,"tag":386,"props":1266,"children":1267},{},[1268,1270,1274],{"type":316,"value":1269},"Open ",{"type":310,"tag":329,"props":1271,"children":1272},{},[1273],{"type":316,"value":57},{"type":316,"value":397},{"type":310,"tag":386,"props":1276,"children":1277},{},[1278,1279,1284,1285,1290],{"type":316,"value":390},{"type":310,"tag":329,"props":1280,"children":1281},{},[1282],{"type":316,"value":1283},"More",{"type":316,"value":421},{"type":310,"tag":329,"props":1286,"children":1287},{},[1288],{"type":316,"value":1289},"Add provided property",{"type":316,"value":397},{"type":310,"tag":386,"props":1292,"children":1293},{},[1294],{"type":316,"value":1295},"Add Author, Pages, Favorite, Rating, and Finished on. Keep Favorite as a property only if the Book schema tracks both Yes and No.",{"type":310,"tag":318,"props":1297,"children":1298},{},[1299,1301,1306,1308,1313,1315,1320],{"type":316,"value":1300},"When you tag another block with ",{"type":310,"tag":356,"props":1302,"children":1304},{"className":1303},[],[1305],{"type":316,"value":1241},{"type":316,"value":1307},", its Properties panel shows the available fields under ",{"type":310,"tag":329,"props":1309,"children":1310},{},[1311],{"type":316,"value":1312},"From Book",{"type":316,"value":1314},". Select a field or ",{"type":310,"tag":329,"props":1316,"children":1317},{},[1318],{"type":316,"value":1319},"Add all",{"type":316,"value":1321}," to attach the fields you want.",{"type":310,"tag":318,"props":1323,"children":1324},{},[1325],{"type":316,"value":1326},"The tag provides the property definitions, not their values. You still enter the author, favorite state, rating, and finish date for each book.",{"type":310,"tag":318,"props":1328,"children":1329},{},[1330],{"type":310,"tag":657,"props":1331,"children":1334},{"alt":1332,"src":1333},"The Book tag configured to provide Author, Pages, Favorite, Rating, and Finished on","/assets/docs/properties/provided-properties.webp",[],{"type":310,"tag":337,"props":1336,"children":1338},{"id":1337},"use-properties-in-views",[1339],{"type":316,"value":1340},"Use properties in views",{"type":310,"tag":318,"props":1342,"children":1343},{},[1344],{"type":316,"value":1345},"The same property can power several views without duplicating data:",{"type":310,"tag":674,"props":1347,"children":1348},{},[1349,1354,1359,1364],{"type":310,"tag":386,"props":1350,"children":1351},{},[1352],{"type":316,"value":1353},"Add Pages, Rating, and Author as Table columns for comparison and inline editing.",{"type":310,"tag":386,"props":1355,"children":1356},{},[1357],{"type":316,"value":1358},"Use Finished on as a Calendar date source.",{"type":310,"tag":386,"props":1360,"children":1361},{},[1362],{"type":316,"value":1363},"Filter a Board view by Reading status. Board lanes themselves use tags.",{"type":310,"tag":386,"props":1365,"children":1366},{},[1367],{"type":316,"value":1368},"Filter or sort a view by any reusable property.",{"type":310,"tag":318,"props":1370,"children":1371},{},[1372],{"type":310,"tag":657,"props":1373,"children":1376},{"alt":1374,"src":1375},"The Book collection in Table view using built-in columns and reusable properties","/assets/docs/table/book-table-view.webp",[],{"type":310,"tag":318,"props":1378,"children":1379},{},[1380,1382,1387,1389,1394,1396,1401,1403,1408],{"type":316,"value":1381},"The table starts with the default ",{"type":310,"tag":329,"props":1383,"children":1384},{},[1385],{"type":316,"value":1386},"Title",{"type":316,"value":1388}," column, adds the built-in ",{"type":310,"tag":329,"props":1390,"children":1391},{},[1392],{"type":316,"value":1393},"Created",{"type":316,"value":1395}," and ",{"type":310,"tag":329,"props":1397,"children":1398},{},[1399],{"type":316,"value":1400},"Tags",{"type":316,"value":1402}," columns, then adds Author, Pages, Finished on, and ISBN as reusable property columns. See ",{"type":310,"tag":1404,"props":1405,"children":1406},"a",{"href":33},[1407],{"type":316,"value":34},{"type":316,"value":1409}," for the complete setup, editing, filtering, and sorting workflow.",{"type":310,"tag":318,"props":1411,"children":1412},{},[1413,1415,1420,1422,1426],{"type":316,"value":1414},"When a view asks which property to use, select the existing compatible property. For example, set Calendar's date source to ",{"type":310,"tag":356,"props":1416,"children":1418},{"className":1417},[],[1419],{"type":316,"value":576},{"type":316,"value":1421},". See ",{"type":310,"tag":1404,"props":1423,"children":1424},{"href":121},[1425],{"type":316,"value":122},{"type":316,"value":397},{"type":310,"tag":318,"props":1428,"children":1429},{},[1430],{"type":310,"tag":657,"props":1431,"children":1434},{"alt":1432,"src":1433},"Calendar configured to use Finished on as its date source","/assets/docs/properties/app-property-mapping.webp",[],{"type":310,"tag":318,"props":1436,"children":1437},{},[1438],{"type":316,"value":1439},"Changing a view mapping changes only how that view reads or writes data. It does not rename properties, copy values, or modify other views.",{"type":310,"tag":344,"props":1441,"children":1443},{"id":1442},"filter-by-whether-a-property-is-set",[1444],{"type":316,"value":1445},"Filter by whether a property is set",{"type":310,"tag":318,"props":1447,"children":1448},{},[1449],{"type":316,"value":1450},"This uses the same Required, Additive, and Excluded filters as tags:",{"type":310,"tag":382,"props":1452,"children":1453},{},[1454,1464,1489,1501],{"type":310,"tag":386,"props":1455,"children":1456},{},[1457,1459,1463],{"type":316,"value":1458},"Open the view and select ",{"type":310,"tag":329,"props":1460,"children":1461},{},[1462],{"type":316,"value":45},{"type":316,"value":397},{"type":310,"tag":386,"props":1465,"children":1466},{},[1467,1469,1474,1476,1481,1483,1488],{"type":316,"value":1468},"Add the property block under ",{"type":310,"tag":329,"props":1470,"children":1471},{},[1472],{"type":316,"value":1473},"Required",{"type":316,"value":1475},", ",{"type":310,"tag":329,"props":1477,"children":1478},{},[1479],{"type":316,"value":1480},"Additive",{"type":316,"value":1482},", or ",{"type":310,"tag":329,"props":1484,"children":1485},{},[1486],{"type":316,"value":1487},"Excluded",{"type":316,"value":397},{"type":310,"tag":386,"props":1490,"children":1491},{},[1492,1494,1499],{"type":316,"value":1493},"Select the new filter chip to open its ",{"type":310,"tag":329,"props":1495,"children":1496},{},[1497],{"type":316,"value":1498},"Links",{"type":316,"value":1500}," settings.",{"type":310,"tag":386,"props":1502,"children":1503},{},[1504,1506,1510],{"type":316,"value":1505},"Set the link type to ",{"type":310,"tag":329,"props":1507,"children":1508},{},[1509],{"type":316,"value":57},{"type":316,"value":1511},". Turn off Tags and Mentions if you only want property matches.",{"type":310,"tag":318,"props":1513,"children":1514},{},[1515],{"type":316,"value":1516},"The view now matches blocks that have that property set. Required means every result must have it, Additive includes matching blocks, and Excluded removes them.",{"type":310,"tag":344,"props":1518,"children":1520},{"id":1519},"filter-by-a-property-value",[1521],{"type":316,"value":1522},"Filter by a property value",{"type":310,"tag":382,"props":1524,"children":1525},{},[1526,1541,1551,1562,1591],{"type":310,"tag":386,"props":1527,"children":1528},{},[1529,1530,1534,1536,1540],{"type":316,"value":1269},{"type":310,"tag":329,"props":1531,"children":1532},{},[1533],{"type":316,"value":45},{"type":316,"value":1535}," and find ",{"type":310,"tag":329,"props":1537,"children":1538},{},[1539],{"type":316,"value":57},{"type":316,"value":397},{"type":310,"tag":386,"props":1542,"children":1543},{},[1544,1545,1550],{"type":316,"value":390},{"type":310,"tag":329,"props":1546,"children":1547},{},[1548],{"type":316,"value":1549},"Add property filter",{"type":316,"value":397},{"type":310,"tag":386,"props":1552,"children":1553},{},[1554,1555,1560],{"type":316,"value":390},{"type":310,"tag":329,"props":1556,"children":1557},{},[1558],{"type":316,"value":1559},"Choose property",{"type":316,"value":1561},", then choose the reusable property.",{"type":310,"tag":386,"props":1563,"children":1564},{},[1565,1567,1572,1573,1578,1579,1584,1585,1590],{"type":316,"value":1566},"Choose an operator such as ",{"type":310,"tag":329,"props":1568,"children":1569},{},[1570],{"type":316,"value":1571},"Is not empty",{"type":316,"value":1475},{"type":310,"tag":329,"props":1574,"children":1575},{},[1576],{"type":316,"value":1577},"Equals",{"type":316,"value":1475},{"type":310,"tag":329,"props":1580,"children":1581},{},[1582],{"type":316,"value":1583},"Greater than",{"type":316,"value":1482},{"type":310,"tag":329,"props":1586,"children":1587},{},[1588],{"type":316,"value":1589},"Between",{"type":316,"value":397},{"type":310,"tag":386,"props":1592,"children":1593},{},[1594],{"type":316,"value":1595},"Enter a value when the operator needs one.",{"type":310,"tag":318,"props":1597,"children":1598},{},[1599,1601,1605],{"type":316,"value":1600},"Use ",{"type":310,"tag":329,"props":1602,"children":1603},{},[1604],{"type":316,"value":1571},{"type":316,"value":1606}," to show every block with a value for that property. The available operators and value editor match the property's type.",{"type":310,"tag":344,"props":1608,"children":1610},{"id":1609},"sort-by-a-property",[1611],{"type":316,"value":1612},"Sort by a property",{"type":310,"tag":382,"props":1614,"children":1615},{},[1616,1626,1643,1648],{"type":310,"tag":386,"props":1617,"children":1618},{},[1619,1620,1625],{"type":316,"value":1458},{"type":310,"tag":329,"props":1621,"children":1622},{},[1623],{"type":316,"value":1624},"Sort",{"type":316,"value":397},{"type":310,"tag":386,"props":1627,"children":1628},{},[1629,1631,1635,1637,1642],{"type":316,"value":1630},"Under ",{"type":310,"tag":329,"props":1632,"children":1633},{},[1634],{"type":316,"value":57},{"type":316,"value":1636},", select ",{"type":310,"tag":329,"props":1638,"children":1639},{},[1640],{"type":316,"value":1641},"Search property",{"type":316,"value":397},{"type":310,"tag":386,"props":1644,"children":1645},{},[1646],{"type":316,"value":1647},"Choose the reusable property.",{"type":310,"tag":386,"props":1649,"children":1650},{},[1651],{"type":316,"value":1652},"Use the arrow beside it to switch between ascending and descending order.",{"type":310,"tag":318,"props":1654,"children":1655},{},[1656],{"type":316,"value":1657},"Blocks without a value for the selected property appear last.",{"type":310,"tag":337,"props":1659,"children":1661},{"id":1660},"rename-clear-or-remove-a-property",[1662],{"type":316,"value":1663},"Rename, clear, or remove a property",{"type":310,"tag":318,"props":1665,"children":1666},{},[1667],{"type":316,"value":1668},"Select the property name to open its menu:",{"type":310,"tag":674,"props":1670,"children":1671},{},[1672,1682,1692,1701],{"type":310,"tag":386,"props":1673,"children":1674},{},[1675,1680],{"type":310,"tag":329,"props":1676,"children":1677},{},[1678],{"type":316,"value":1679},"Rename",{"type":316,"value":1681}," changes the inline name or the reusable property block's shared name.",{"type":310,"tag":386,"props":1683,"children":1684},{},[1685,1690],{"type":310,"tag":329,"props":1686,"children":1687},{},[1688],{"type":316,"value":1689},"Change type",{"type":316,"value":1691}," is available for inline properties.",{"type":310,"tag":386,"props":1693,"children":1694},{},[1695,1699],{"type":310,"tag":329,"props":1696,"children":1697},{},[1698],{"type":316,"value":1165},{"type":316,"value":1700}," lets you reconfigure a reusable property.",{"type":310,"tag":386,"props":1702,"children":1703},{},[1704,1709],{"type":310,"tag":329,"props":1705,"children":1706},{},[1707],{"type":316,"value":1708},"Remove",{"type":316,"value":1710}," removes the property and its value from the current block.",{"type":310,"tag":318,"props":1712,"children":1713},{},[1714,1716,1721],{"type":316,"value":1715},"Clearing a value is different from removing its property. An empty ",{"type":310,"tag":356,"props":1717,"children":1719},{"className":1718},[],[1720],{"type":316,"value":576},{"type":316,"value":1722}," field still tells Heaper that the book can have a finish date. Removing it removes that field from the block.",{"type":310,"tag":318,"props":1724,"children":1725},{},[1726],{"type":316,"value":1727},"If two reusable properties have the same name but different identities, Heaper keeps them separate. Open their property blocks to decide which one you want to reuse.",{"type":310,"tag":337,"props":1729,"children":1731},{"id":1730},"choosing-the-right-type",[1732],{"type":316,"value":1733},"Choosing the right type",{"type":310,"tag":318,"props":1735,"children":1736},{},[1737],{"type":316,"value":1738},"First decide whether you need a property. Use a tag for a one-way state. Use Checkbox only when you need both Yes and No.",{"type":310,"tag":318,"props":1740,"children":1741},{},[1742],{"type":316,"value":1743},"Then choose the value type:",{"type":310,"tag":382,"props":1745,"children":1746},{},[1747,1752,1757,1762,1767],{"type":310,"tag":386,"props":1748,"children":1749},{},[1750],{"type":316,"value":1751},"Text: free text, names, codes, and identifiers.",{"type":310,"tag":386,"props":1753,"children":1754},{},[1755],{"type":316,"value":1756},"Number: numeric values, units, money, percentages, and ratings.",{"type":310,"tag":386,"props":1758,"children":1759},{},[1760],{"type":316,"value":1761},"Date: dates, times, ranges, reminders, and Calendar values.",{"type":310,"tag":386,"props":1763,"children":1764},{},[1765],{"type":316,"value":1766},"Choice: one or more options from a fixed set.",{"type":310,"tag":386,"props":1768,"children":1769},{},[1770],{"type":316,"value":1771},"Reference: links to blocks, people, files, or places.",{"title":304,"searchDepth":28,"depth":28,"links":1773},[1774,1779,1780,1783,1787,1788,1791,1796,1797],{"id":339,"depth":28,"text":342,"children":1775},[1776,1777,1778],{"id":346,"depth":66,"text":349},{"id":377,"depth":66,"text":380},{"id":463,"depth":66,"text":466},{"id":664,"depth":28,"text":667},{"id":721,"depth":28,"text":724,"children":1781},[1782],{"id":868,"depth":66,"text":871},{"id":1049,"depth":28,"text":1052,"children":1784},[1785,1786],{"id":1055,"depth":66,"text":1058},{"id":1108,"depth":66,"text":1111},{"id":1152,"depth":28,"text":1155},{"id":1227,"depth":28,"text":1230,"children":1789},[1790],{"id":1246,"depth":66,"text":1249},{"id":1337,"depth":28,"text":1340,"children":1792},[1793,1794,1795],{"id":1442,"depth":66,"text":1445},{"id":1519,"depth":66,"text":1522},{"id":1609,"depth":66,"text":1612},{"id":1660,"depth":28,"text":1663},{"id":1730,"depth":28,"text":1733},"markdown","content:docs:properties.md","content","docs/properties.md","docs/properties","md",1785777127156]