@directus/app 9.16.1 → 9.17.2

package/dist/assets/{collections.7776a374.js → collections.18cc2518.js}

@@ -1,2 +1,2 @@
-import{a as i,o as d,b as r,w as o,g as t,e as s,B as e}from"./runtime-core.esm-bundler.e3d5f5b7.js";const u={class:"markdown-body"},h=t("blockquote",null,[t("p",null,"Collections are a set of items. This can be a 1-1 data table in SQL, a group of other collections, or a readonly view. They come with all the same power and functionality of data tables, despite the less technical name.")],-1),_=t("h2",{id:"overview",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#overview"},"#"),e(" Overview")],-1),p=t("video",{title:"Overview",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/data-model-20220805/collections-20220805A.mp4",type:"video/mp4"})],-1),f=e("Collections are data tables. Typically, you access items within a collection in the "),m=e("Content Module"),g=e("."),y=t("h2",{id:"system-collections",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#system-collections"},"#"),e(" System Collections")],-1),v=t("video",{title:"System Collections",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/system-collections-20220805A.mp4",type:"video/mp4"})],-1),w=t("p",null,"System collections store the data and configuration details required to power your project.",-1),b=t("p",null,[e("Since system collections store information that powers your Directus project. You cannot reconfigure system collections or any of their default fields, as any reconfigurations would break your project. However, you "),t("em",null,"can"),e(" create and configure new fields on a system collection. This lets you safely customize your data model as desired.")],-1),S=t("p",null,"System collections are not displayed in the Content Module. The following table will go over the logic and functionality each system collection is responsible for, as well as where to find relevant App and API documentation.",-1),C=t("thead",null,[t("tr",null,[t("th",null,"System Collection"),t("th",null,"Purpose"),t("th",null,"APP"),t("th",null,"API")])],-1),T=t("td",null,"Activity",-1),k=t("td",null,"Tracks and stores all events within Directus, giving full accountability over everything.",-1),A=e("Activity Log"),D=e("Activity"),F=t("td",null,"Collections",-1),I=t("td",null,"Stores data table & configuration details each and every Collection.",-1),x=e("Collections"),N=e("Collections"),P=t("td",null,"Dashboards",-1),M=t("td",null,"Stores dashboard configuration details and all relationally linked panels.",-1),O=e("Insights"),R=t("td",null,[t("strong",null,"N/A")],-1),j=t("td",null,"Fields",-1),B=t("td",null,"Stores configuration details for each field.",-1),L=e("Fields"),U=e("Fields"),H=t("td",null,"Files",-1),V=t("td",null,"This stores file location from asset storage as well as any data associated with that file.",-1),E=e("File Library"),q=e("Files"),W=t("td",null,"Flows",-1),K=t("td",null,"Stores basic logic required for Flows, which enable event-triggered task automation.",-1),Q=e("Flows"),Y=e("Flows"),G=t("td",null,"Folders",-1),z=t("td",null,"Stores information required for Folders, which provide virtual file asset management.",-1),J=e("Folders"),X=e("Folders"),Z=t("tr",null,[t("td",null,"Migrations"),t("td",null,"Used by our install/upgrade process to track when migration scripts for a specific release have been run."),t("td",null,"It has no relevant app functionality."),t("td",null,[t("strong",null,"N/A")])],-1),$=t("td",null,"Notifications",-1),tt=t("td",null,"Stores details about in-app notifications.",-1),et=e("Module Bar"),ot=e(" and "),lt=e("Sidebar"),st=e("Notifications"),nt=t("td",null,"Operations",-1),it=t("td",null,[e("Stores information required for Operations, which are a part of "),t("a",{href:"#flows"},"Flows"),e(".")],-1),at=e("Operations"),ct=e("Operations"),dt=t("td",null,"Panels",-1),rt=t("td",null,[e("This stores information about individual analytics panels, which are displayed on "),t("a",{href:"#dashboards"},"Dashboards"),e(".")],-1),ut=e("Insights"),ht=t("td",null,[t("strong",null,"N/A")],-1),_t=t("td",null,"Permissions",-1),pt=t("td",null,"This stores the access permissions configured for roles.",-1),ft=e("Users, Roles & Permissions"),mt=e("Permissions"),gt=t("td",null,"Presets",-1),yt=t("td",null,"This stores details for presets and bookmarks.",-1),vt=e("Presents & Bookmarks"),wt=e("Presets"),bt=t("td",null,"Relations",-1),St=t("td",null,"This stores information about relationships between collections.",-1),Ct=e("Relationships"),Tt=e("Relations"),kt=t("td",null,"Revisions",-1),At=t("td",null,"Revisions are changes/edits made to Items. Directus keeps track of edits made, so you\u2019re able to revert to a previous state at will.",-1),Dt=e("Revert an Item"),Ft=e("Revisions"),It=t("td",null,"Roles",-1),xt=t("td",null,"Stores information about each role created.",-1),Nt=e("Users, Roles, and Permissions"),Pt=e("Roles"),Mt=t("tr",null,[t("td",null,"Sessions"),t("td",null,"Stores information about each user session, for system purposes."),t("td",null,[t("strong",null,"N/A")]),t("td",null,[t("strong",null,"N/A")])],-1),Ot=t("td",null,"Settings",-1),Rt=t("td",null,[e("Stores all configurations made within "),t("strong",null,"Settings > Project Settings"),e(".")],-1),jt=e("Project Settings"),Bt=e("settings"),Lt=t("td",null,"Shares",-1),Ut=t("td",null,"Stores all information regarding data shares.",-1),Ht=e("Data Sharing"),Vt=t("td",null,null,-1),Et=t("td",null,"Users",-1),qt=t("td",null,"Stores information about each user within the platform.",-1),Wt=e("User Directory"),Kt=e("Users"),Qt=t("td",null,"Webhooks",-1),Yt=t("td",null,"Stores all information about configured webhooks.",-1),Gt=e("Webhooks"),zt=e("Webhooks"),Jt=t("h2",{id:"create-a-collection",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#create-a-collection"},"#"),e(" Create a Collection")],-1),Xt=t("video",{title:"Create a Collection",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:`https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/create-a-collection-20220805A.mp4
-`,type:"video/mp4"})],-1),Zt=t("p",null,"To create a collection, follow these steps.",-1),$t=t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(", click "),t("span",{mi:"",btn:""},"add"),e(" in the page header, and a drawer will open.")],-1),te=t("li",null,[e("Enter a unique "),t("strong",null,"Collection Name"),e(". This cannot be modified later, but can be translated."),t("br"),e(" This is used as the data table key, API collection key, and default collection name.")],-1),ee=e("Optional: Make any other configurations as desired. "),oe=t("li",null,[t("strong",null,"Singleton"),e(" \u2014 Toggles whether the collection is a "),t("a",{href:"#collection-setup"},"Singleton"),e(".")],-1),le=t("li",null,[t("strong",null,"Primary Key Field"),e(" \u2014 Sets the name of the primary key field, defaults to "),t("code",null,"id"),e(".")],-1),se=t("strong",null,"Type",-1),ne=e(" \u2014 Sets the "),ie=e("type of ID"),ae=e(" to use for this collection."),ce=t("li",null,[e("Click "),t("span",{mi:"",btn:""},"arrow_forward"),e(" to confirm.")],-1),de=t("li",null,[e("Enable and rename the other Optional System Fields as desired: "),t("ul",null,[t("li",null,[t("strong",null,"Status"),e(" \u2014 Stores item status.")]),t("li",null,[t("strong",null,"Sort"),e(" \u2014 Adds a field which enables drag-and-drop sorting of items.")]),t("li",null,[t("strong",null,"Created On"),e(" \u2014 Logs the date an item was created.")]),t("li",null,[t("strong",null,"Created By"),e(" \u2014 Logs the user that created this item.")]),t("li",null,[t("strong",null,"Updated On"),e(" \u2014 Logs the date an item was last updated.")]),t("li",null,[t("strong",null,"Updated By"),e(" \u2014 Stores the last user to edit the file.")])])],-1),re=t("li",null,[e("Click "),t("span",{mi:"",btn:""},"check"),e(" to confirm and create the collection.")],-1),ue=t("div",{class:"danger hint"},[t("div",{class:"hint-title"},"Immutable Keys"),t("p",null,[e("The collection name from step two cannot be modified after collection creation. However, you can override how it is displayed with "),t("a",{href:"#collection-setup"},"Collection Naming Translations"),e(".")])],-1),he=t("div",{class:"warning hint"},[t("div",{class:"hint-title"},"Composite Keys"),t("p",null,"Directus does not currently support composite keys. If your project uses composite keys, you will need to make an adjustment to the data model.")],-1),_e=t("div",{class:"warning hint"},[t("div",{class:"hint-title"},"SQL Views"),t("p",null,"Directus does not currently support creation of virtual tables via SQL Views.")],-1),pe=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Database Tables"),t("p",null,[e("Remember, a collection is simply a database table. Therefore, you can import or create a table directly in the database and it will automatically appear within your Directus project. The first time you manage that table, a "),t("code",null,"directus_collections"),e(" record will be created with default values.")])],-1),fe=t("h2",{id:"toggle-collection-visibility",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#toggle-collection-visibility"},"#"),e(" Toggle Collection Visibility")],-1),me=t("video",{title:"Hide a Collection",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/toggle-collection-visibility-20220805A.mp4",type:"video/mp4"})],-1),ge=t("p",null,"To toggle whether a collection is hidden by default in the Content Module, follow these steps.",-1),ye=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(".")]),t("li",null,[e("Click "),t("span",{mi:"",icon:""},"more_vert"),e(" to open the collection\u2019s Context Menu.")]),t("li",null,[e("Select "),t("strong",null,"View Content"),e(" or "),t("strong",null,"Make Collection Hidden"),e(" to adjust visibility as desired.")])],-1),ve={class:"tip hint"},we=e("Assuming a user has "),be=e("access permissions"),Se=e(", hidden collections can still be viewed. They must right-click on the Navigation Bar and choose "),Ce=t("span",{mi:"",icon:""},"visibility",-1),Te=e(),ke=t("strong",null,"Show Hidden Collections",-1),Ae=e("."),De=t("h2",{id:"create-a-folder",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#create-a-folder"},"#"),e(" Create a Folder")],-1),Fe=t("video",{title:"Create a Folder",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/create-a-folder-20220805A.mp4",type:"video/mp4"})],-1),Ie=t("p",null,[e("Folders allow you to sub-nest and group how collections are displayed. This feature simply changes how the collections are displayed under "),t("strong",null,"Settings > Data Model"),e(" and in the Content Module. It has no impact on the data model. To create a folder, follow these steps.")],-1),xe=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(".")]),t("li",null,[e("Click "),t("span",{mi:"",btn:"",muted:""},"create_new_folder"),e(" in the page header.")]),t("li",null,"Set a folder key, which will also be used as the folder\u2019s name."),t("li",null,"Optional: Set the folder icon, color, note and translations as desired."),t("li",null,[e("Click "),t("strong",null,"Save"),e(" to create your folder.")])],-1),Ne=t("h2",{id:"toggle-folder-display",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#toggle-folder-display"},"#"),e(" Toggle Folder Display")],-1),Pe=t("video",{title:"Toggle Folder Display",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/toggle-folder-display-20220805A.mp4",type:"video/mp4"})],-1),Me=t("p",null,"To toggle folder display, follow these steps.",-1),Oe=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(".")]),t("li",null,[e("Click "),t("span",{mi:"",icon:""},"folder"),e(" on the desired collection to toggle the following displays: "),t("ul",null,[t("li",null,[t("strong",null,"Start Open")]),t("li",null,[t("strong",null,"Start Collapsed")]),t("li",null,[t("strong",null,"Always Open")])])])],-1),Re=t("h2",{id:"sort-and-nest-collections",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#sort-and-nest-collections"},"#"),e(" Sort and Nest Collections")],-1),je=t("video",{title:"Configure a Collection",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/sort-and-nest-collections.mp4",type:"video/mp4"})],-1),Be=t("p",null,[e("To sort and nest collections in "),t("strong",null,"Settings > Data Model"),e(" and "),t("strong",null,"Content Module"),e(", follow these steps.")],-1),Le=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(".")]),t("li",null,[e("Click and drag "),t("span",{mi:"",icon:""},"drag_handle"),e(" to position collections as desired."),t("br"),e(" To nest a collection, drag below and to the right of an intended parent folder or collection.")])],-1),Ue=t("h2",{id:"configure-a-collection",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#configure-a-collection"},"#"),e(" Configure a Collection")],-1),He=t("video",{title:"Configure a Collection",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/configure-a-collection-20220805A.mp4",type:"video/mp4"})],-1),Ve=t("p",null,"To configure a collection, follow these steps.",-1),Ee=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(" and click the desired collection."),t("br"),e(" The collection\u2019s configuration page will open.")]),t("li",null,[e("Make configurations as desired. Configuration options are broken into six categories. "),t("ul",null,[t("li",null,[t("a",{href:"#fields-layout"},"Fields and Layout")]),t("li",null,[t("a",{href:"#collection-setup"},"Collection Setup")]),t("li",null,[t("a",{href:"#archive"},"Archive")]),t("li",null,[t("a",{href:"#sort-field"},"Sort")]),t("li",null,[t("a",{href:"#accountability"},"Accountability")]),t("li",null,[t("a",{href:"#duplication"},"Duplication")])])]),t("li",null,[e("Click "),t("span",{mi:"",btn:""},"check"),e(" to confirm.")])],-1),qe=t("h3",{id:"fields-%26-layout",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#fields-%26-layout"},"#"),e(" Fields & Layout")],-1),We=t("video",{title:"Fields and Layout",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/fields-and-layout-20220805A.mp4",type:"video/mp4"})],-1),Ke=e("This section allows you to create and configure fields, as well as configure how fields are displayed on the "),Qe=e("Item Details Page"),Ye=e(". To learn more, please see the documentation on "),Ge=e("fields"),ze=e("."),Je=t("h3",{id:"collection-setup",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#collection-setup"},"#"),e(" Collection Setup")],-1),Xe=t("video",{title:"Collection Setup",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/collection-setup-20220805A.mp4",type:"video/mp4"})],-1),Ze=t("p",null,"These controls allow you to modify how the collection is displayed within the Content Module.",-1),$e=t("li",null,[t("strong",null,"Collection Name"),e(" \u2014 Displays the collection\u2019s name, which cannot be modified. However, you can override the displayed name with Collection Naming Translations, shown lower on this list.")],-1),to=t("li",null,[t("strong",null,"Note"),e(" \u2014 Set a helpful note that explains the collection\u2019s purpose.")],-1),eo=t("li",null,[t("strong",null,"Icon"),e(" \u2014 Set an icon used throughout the app when referencing this collection.")],-1),oo=t("li",null,[t("strong",null,"Color"),e(" \u2014 Set a color for the icon, shown in the Navigation Bar and its page header.")],-1),lo=t("strong",null,"Display Template",-1),so=e(" \u2014 Create a "),no=e("Display Template"),io=e(" for the collection."),ao=t("li",null,[t("strong",null,"Hidden"),e(" \u2014 Toggle whether the collection should be globally hidden in the other app modules, even for admin users. You cannot hide collections for admins via permissions like other roles, so this comes in handy to tidy up the Content Module.")],-1),co=t("strong",null,"Singleton",-1),ro=e(" \u2014 Toggle to bypass the "),uo=e("Collection Page"),ho=e(" and take users to the "),_o=e("Item Details Page"),po=e("."),fo=t("strong",null,"Collection Naming Translations",-1),mo=e(" \u2014 Translate the collection name across multiple languages. When the default language is changed in "),go=e("Project Settings"),yo=e(" or "),vo=e("User Details Page"),wo=e(", the relevant translation, if any exists, will be used throughout the app."),bo={class:"tip hint"},So=t("div",{class:"hint-title"},"Collection Naming Translations",-1),Co=e("By default, Directus uses the "),To=e("Title Formatter"),ko=e(" to display collection keys as human readable names, but you can also use translations to explicitly rename more technical table keys."),Ao=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"What's a Singleton?"),t("p",null,[e("A collection that only contains one single item. For example, a website\u2019s "),t("strong",null,"About Us"),e(" page.")])],-1),Do=t("h3",{id:"archive",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#archive"},"#"),e(" Archive")],-1),Fo=t("video",{title:"Archive",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/archive-20220805A.mp4",type:"video/mp4"})],-1),Io=t("p",null,[e("Selects a field to handle archiving items. This provides a "),t("em",null,"soft-delete"),e(" functionality for items in a collection. Archived items will still exist in the collection and database, but are filtered within the Data Studio. To configure an archive field, set the following four input fields as desired.")],-1),xo=t("li",null,[t("strong",null,"Archive Field"),e(" \u2014 Selects the archive field from a dropdown menu.")],-1),No=t("strong",null,"Archive App Filter",-1),Po=e(" \u2014 Toggles whether app users can "),Mo=e("filter for archived items"),Oo=e("."),Ro=t("strong",null,"Archive Value",-1),jo=e(" \u2014 A value that is assigned to the field when an item is "),Bo=e("archived"),Lo=e("."),Uo=t("strong",null,"Unarchive Value",-1),Ho=e(" \u2014 A value that is assigned to the field when an item is "),Vo=e("unarchived"),Eo=e("."),qo=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Automatic Setup"),t("p",null,[e("When you "),t("a",{href:"#create-a-collection"},"create a collection"),e(", you have the option to create an optional Status Field. If you choose to include this field, the collection\u2019s archive settings will be automatically configured for you.")])],-1),Wo=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Archive Field Values"),t("p",null,"The archive fields can contain any number of additional values besides the archived and unarchived values defined above.")],-1),Ko=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Archived Item Management via API"),t("p",null,"Archived items are hidden in the app by default, but they are still returned normally via the API unless explicitly filtered out. This gives you the flexibility to manage archived items however you want when working with the API.")],-1),Qo=t("h3",{id:"sort-field",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#sort-field"},"#"),e(" Sort Field")],-1),Yo=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Batch Edit Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/manually-sort-items-20220415A.mp4",type:"video/mp4"})],-1),Go=e("The sort feature enables users to "),zo=e("manually sort Items"),Jo=e(" within the Data Studio. This is typically shown on the "),Xo=t("strong",null,"Content Module > Collection Page",-1),Zo=e(". It can also be used for sorting items within "),$o=e("Junction Collections"),tl=e(". A standard field, configured with an "),el=t("code",null,"INTEGER",-1),ol=e(" data type, is required. As shown in the video, fields which cannot serve as sort fields will be grayed out and unselectable in the Sort Field dropdown."),ll=t("p",null,[t("strong",null,"Sort Field"),e(" \u2014 Select a field to custom sort and order items. Click "),t("strong",null,"Deselect"),e(" to disable.")],-1),sl=t("p",null,"To configure a sort field, follow these steps.",-1),nl=e("Create a Field"),il=e(" with an "),al=t("code",null,"INTEGER",-1),cl=e(" data type."),dl=t("li",null,[e("Choose a field from the dropdown under "),t("strong",null,"Settings > Data Model > [Collection] > Sort"),e(".")],-1),rl=t("li",null,[e("Click "),t("span",{mi:"",btn:""},"check"),e(" to confirm.")],-1),ul=e("Once you sort field is configured, you may want to learn how to "),hl=e("manually sort Items"),_l=e("."),pl={class:"tip hint"},fl=t("div",{class:"hint-title"},"Automatic Setup",-1),ml=e("When you "),gl=e("create a Collection"),yl=e(", you have the option of creating a "),vl=t("strong",null,"Sort",-1),wl=e(" field. If you choose to include this field, the collection\u2019s sort settings will automatically be configured for you."),bl=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Interface Sorting"),t("p",null,[e("To configure manual sorting within a relational Interface (e.g., M2M, O2M, or M2A), configure as above, but also set the "),t("strong",null,"Sort Field"),e(" within the relationship section of the field\u2019s configuration drawer.")])],-1),Sl=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Configure to Hidden"),t("p",null,[e("You can also set this field to be "),t("strong",null,"Hidden"),e(" so it doesn\u2019t show up within the Item Details Page.")])],-1),Cl=t("h3",{id:"accountability",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#accountability"},"#"),e(" Accountability")],-1),Tl=t("video",{title:"Accountability",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/acountability-20220805A.mp4",type:"video/mp4"})],-1),kl=e("By default, your Directus Project tracks all "),Al=e("activity"),Dl=e(" and "),Fl=e("revisions"),Il=e(" for collections. However, you can override this and choose what data is tracked."),xl=t("ul",null,[t("li",null,[t("strong",null,"Activity & Revision Tracking"),e(" \u2014 The following options are supported: "),t("ul",null,[t("li",null,[t("strong",null,"Track Activity & Revisions")]),t("li",null,[t("strong",null,"Only Track Activity")]),t("li",null,[t("strong",null,"Do Not Track Anything")])])])],-1),Nl={class:"tip hint"},Pl=t("div",{class:"hint-title"},"Accountability vs. Telemetry",-1),Ml=e("Accountability is a log of "),Ol=t("em",null,"who does what",-1),Rl=e(" in your project. It is for your team\u2019s own use. This is different from "),jl=e("telemetry"),Bl=e(", which is configured under "),Ll=e("environment variables"),Ul=e("."),Hl=t("h3",{id:"duplication",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#duplication"},"#"),e(" Duplication")],-1),Vl=t("video",{title:"Duplication",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/duplicate-20220805A.mp4",type:"video/mp4"})],-1),El=t("p",null,[e("The "),t("strong",null,"Save as Copy"),e(" option on the Item Details Page offers a way to effectively duplicate the current item. Since there may be unique or relational data within the item, it\u2019s important to control exactly what will be copied. Duplication lets you configure which parent & relational field values will be copied when you use "),t("strong",null,"Save as Copy"),e(" on an item.")],-1),ql=t("ul",null,[t("li",null,[t("strong",null,"Item Duplication Fields"),e(" \u2014 Check the field(s) to copy values for when duplicating an item.")])],-1),Wl=t("h2",{id:"delete-a-collection",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#delete-a-collection"},"#"),e(" Delete a Collection")],-1),Kl=t("video",{title:"Delete a Collection",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/delete-a-collection-20220805A.mp4",type:"video/mp4"})],-1),Ql=t("p",null,"To delete a collection, follow these steps.",-1),Yl=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model > [Collection Name]"),e(".")]),t("li",null,[e("Click "),t("span",{mi:"",btn:"",dngr:""},"delete"),e(" in the page header.")]),t("li",null,[e("Confirm this decision by clicking "),t("strong",null,"Delete"),e(" in the dialog.")])],-1),Gl=t("div",{class:"danger hint"},[t("p",null,"This action is permanent and irreversible. Please proceed with caution.")],-1),$l="Collections",ts=!1,es={name:"collections",setup(zl,{expose:a}){const n={title:"Collections",modularExtension:!1};return a({frontmatter:n}),(Jl,Xl)=>{const l=i("router-link"),c=i("docs-wrapper");return d(),r(c,{frontmatter:n},{default:o(()=>[t("div",u,[h,_,p,t("p",null,[f,s(l,{to:"/docs/app/content"},{default:o(()=>[m]),_:1}),g]),y,v,w,b,S,t("table",null,[C,t("tbody",null,[t("tr",null,[T,k,t("td",null,[s(l,{to:"/docs/configuration/activity-log"},{default:o(()=>[A]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/activity"},{default:o(()=>[D]),_:1})])]),t("tr",null,[F,I,t("td",null,[s(l,{to:"/docs/configuration/data-model/collections"},{default:o(()=>[x]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/collections"},{default:o(()=>[N]),_:1})])]),t("tr",null,[P,M,t("td",null,[s(l,{to:"/docs/app/insights"},{default:o(()=>[O]),_:1})]),R]),t("tr",null,[j,B,t("td",null,[s(l,{to:"/docs/configuration/data-model/fields/"},{default:o(()=>[L]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/fields"},{default:o(()=>[U]),_:1})])]),t("tr",null,[H,V,t("td",null,[s(l,{to:"/docs/app/file-library"},{default:o(()=>[E]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/files"},{default:o(()=>[q]),_:1})])]),t("tr",null,[W,K,t("td",null,[s(l,{to:"/docs/configuration/flows"},{default:o(()=>[Q]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/flows"},{default:o(()=>[Y]),_:1})])]),t("tr",null,[G,z,t("td",null,[s(l,{to:"/docs/app/file-library#folders"},{default:o(()=>[J]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/folders"},{default:o(()=>[X]),_:1})])]),Z,t("tr",null,[$,tt,t("td",null,[s(l,{to:"/docs/app/overview#_1-module-bar"},{default:o(()=>[et]),_:1}),ot,s(l,{to:"/docs/app/overview#_4-sidebar"},{default:o(()=>[lt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/notifications"},{default:o(()=>[st]),_:1})])]),t("tr",null,[nt,it,t("td",null,[s(l,{to:"/docs/configuration/flows"},{default:o(()=>[at]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/operations.md"},{default:o(()=>[ct]),_:1})])]),t("tr",null,[dt,rt,t("td",null,[s(l,{to:"/docs/app/insights"},{default:o(()=>[ut]),_:1})]),ht]),t("tr",null,[_t,pt,t("td",null,[s(l,{to:"/docs/configuration/users-roles-permissions"},{default:o(()=>[ft]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/permissions"},{default:o(()=>[mt]),_:1})])]),t("tr",null,[gt,yt,t("td",null,[s(l,{to:"/docs/configuration/presets-bookmarks"},{default:o(()=>[vt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/presets"},{default:o(()=>[wt]),_:1})])]),t("tr",null,[bt,St,t("td",null,[s(l,{to:"/docs/configuration/data-model/relationships"},{default:o(()=>[Ct]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/relations"},{default:o(()=>[Tt]),_:1})])]),t("tr",null,[kt,At,t("td",null,[s(l,{to:"/docs/app/content/items#revert-an-item"},{default:o(()=>[Dt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/revisions"},{default:o(()=>[Ft]),_:1})])]),t("tr",null,[It,xt,t("td",null,[s(l,{to:"/docs/configuration/users-roles-permissions"},{default:o(()=>[Nt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/roles"},{default:o(()=>[Pt]),_:1})])]),Mt,t("tr",null,[Ot,Rt,t("td",null,[s(l,{to:"/docs/configuration/project-settings"},{default:o(()=>[jt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/settings"},{default:o(()=>[Bt]),_:1})])]),t("tr",null,[Lt,Ut,t("td",null,[s(l,{to:"/docs/app/content/shares"},{default:o(()=>[Ht]),_:1})]),Vt]),t("tr",null,[Et,qt,t("td",null,[s(l,{to:"/docs/app/user-directory"},{default:o(()=>[Wt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/relations"},{default:o(()=>[Kt]),_:1})])]),t("tr",null,[Qt,Yt,t("td",null,[s(l,{to:"/docs/configuration/webhooks"},{default:o(()=>[Gt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/relations"},{default:o(()=>[zt]),_:1})])])])]),Jt,Xt,Zt,t("ol",null,[$t,te,t("li",null,[ee,t("ul",null,[oe,le,t("li",null,[se,ne,s(l,{to:"/docs/configuration/data-model/fields/#keys-and-ids"},{default:o(()=>[ie]),_:1}),ae])])]),ce,de,re]),ue,he,_e,pe,fe,me,ge,ye,t("div",ve,[t("p",null,[we,s(l,{to:"/docs/configuration/users-roles-permissions"},{default:o(()=>[be]),_:1}),Se,Ce,Te,ke,Ae])]),De,Fe,Ie,xe,Ne,Pe,Me,Oe,Re,je,Be,Le,Ue,He,Ve,Ee,qe,We,t("p",null,[Ke,s(l,{to:"/docs/app/content/items"},{default:o(()=>[Qe]),_:1}),Ye,s(l,{to:"/docs/configuration/data-model/fields/"},{default:o(()=>[Ge]),_:1}),ze]),Je,Xe,Ze,t("ul",null,[$e,to,eo,oo,t("li",null,[lo,so,s(l,{to:"/docs/app/display-templates"},{default:o(()=>[no]),_:1}),io]),ao,t("li",null,[co,ro,s(l,{to:"/docs/app/content/collections"},{default:o(()=>[uo]),_:1}),ho,s(l,{to:"/docs/app/content/items"},{default:o(()=>[_o]),_:1}),po]),t("li",null,[fo,mo,s(l,{to:"/docs/configuration/project-settings#general"},{default:o(()=>[go]),_:1}),yo,s(l,{to:"/docs/app/user-directory#user-details-page"},{default:o(()=>[vo]),_:1}),wo])]),t("div",bo,[So,t("p",null,[Co,s(l,{to:"/docs/getting-started/glossary#title-formatter"},{default:o(()=>[To]),_:1}),ko])]),Ao,Do,Fo,Io,t("ul",null,[xo,t("li",null,[No,Po,s(l,{to:"/docs/app/content/collections#view-archived-items"},{default:o(()=>[Mo]),_:1}),Oo]),t("li",null,[Ro,jo,s(l,{to:"/docs/app/content/items#archive-an-item"},{default:o(()=>[Bo]),_:1}),Lo]),t("li",null,[Uo,Ho,s(l,{to:"/docs/app/content/items#archive-an-item"},{default:o(()=>[Vo]),_:1}),Eo])]),qo,Wo,Ko,Qo,Yo,t("p",null,[Go,s(l,{to:"/docs/app/content/collections#manually-sort-items"},{default:o(()=>[zo]),_:1}),Jo,Xo,Zo,s(l,{to:"/docs/getting-started/glossary#junction-collections"},{default:o(()=>[$o]),_:1}),tl,el,ol]),ll,sl,t("ol",null,[t("li",null,[s(l,{to:"/docs/configuration/data-model/fields/#create-a-field-standard"},{default:o(()=>[nl]),_:1}),il,al,cl]),dl,rl]),t("p",null,[ul,s(l,{to:"/docs/app/content/collections#manually-sort-items"},{default:o(()=>[hl]),_:1}),_l]),t("div",pl,[fl,t("p",null,[ml,s(l,{to:"/docs/configuration/data-model/collections#create-a-collection"},{default:o(()=>[gl]),_:1}),yl,vl,wl])]),bl,Sl,Cl,Tl,t("p",null,[kl,s(l,{to:"/docs/reference/system/activity"},{default:o(()=>[Al]),_:1}),Dl,s(l,{to:"/docs/reference/system/revisions"},{default:o(()=>[Fl]),_:1}),Il]),xl,t("div",Nl,[Pl,t("p",null,[Ml,Ol,Rl,s(l,{to:"/docs/self-hosted/config-options#telemetry"},{default:o(()=>[jl]),_:1}),Bl,s(l,{to:"/docs/self-hosted/config-options#telemetry"},{default:o(()=>[Ll]),_:1}),Ul])]),Hl,Vl,El,ql,Wl,Kl,Ql,Yl,Gl])]),_:1})}}};export{es as default,ts as modularExtension,$l as title};
+import{a as i,o as d,b as r,w as o,l as t,e as s,E as e}from"./runtime-core.esm-bundler.32cac88a.js";const u={class:"markdown-body"},h=t("blockquote",null,[t("p",null,"Collections are a set of items. This can be a 1-1 data table in SQL, a group of other collections, or a readonly view. They come with all the same power and functionality of data tables, despite the less technical name.")],-1),_=t("h2",{id:"overview",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#overview"},"#"),e(" Overview")],-1),p=t("video",{title:"Overview",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/data-model-20220805/collections-20220805A.mp4",type:"video/mp4"})],-1),f=e("Collections are data tables. Typically, you access items within a collection in the "),m=e("Content Module"),g=e("."),y=t("h2",{id:"system-collections",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#system-collections"},"#"),e(" System Collections")],-1),v=t("video",{title:"System Collections",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/system-collections-20220805A.mp4",type:"video/mp4"})],-1),w=t("p",null,"System collections store the data and configuration details required to power your project.",-1),b=t("p",null,[e("Since system collections store information that powers your Directus project. You cannot reconfigure system collections or any of their default fields, as any reconfigurations would break your project. However, you "),t("em",null,"can"),e(" create and configure new fields on a system collection. This lets you safely customize your data model as desired.")],-1),S=t("p",null,"System collections are not displayed in the Content Module. The following table will go over the logic and functionality each system collection is responsible for, as well as where to find relevant App and API documentation.",-1),C=t("thead",null,[t("tr",null,[t("th",null,"System Collection"),t("th",null,"Purpose"),t("th",null,"APP"),t("th",null,"API")])],-1),T=t("td",null,"Activity",-1),k=t("td",null,"Tracks and stores all events within Directus, giving full accountability over everything.",-1),A=e("Activity Log"),D=e("Activity"),F=t("td",null,"Collections",-1),I=t("td",null,"Stores data table & configuration details each and every Collection.",-1),x=e("Collections"),N=e("Collections"),P=t("td",null,"Dashboards",-1),M=t("td",null,"Stores dashboard configuration details and all relationally linked panels.",-1),O=e("Insights"),R=t("td",null,[t("strong",null,"N/A")],-1),j=t("td",null,"Fields",-1),B=t("td",null,"Stores configuration details for each field.",-1),L=e("Fields"),U=e("Fields"),E=t("td",null,"Files",-1),H=t("td",null,"This stores file location from asset storage as well as any data associated with that file.",-1),V=e("File Library"),q=e("Files"),W=t("td",null,"Flows",-1),K=t("td",null,"Stores basic logic required for Flows, which enable event-triggered task automation.",-1),Q=e("Flows"),Y=e("Flows"),G=t("td",null,"Folders",-1),z=t("td",null,"Stores information required for Folders, which provide virtual file asset management.",-1),J=e("Folders"),X=e("Folders"),Z=t("tr",null,[t("td",null,"Migrations"),t("td",null,"Used by our install/upgrade process to track when migration scripts for a specific release have been run."),t("td",null,"It has no relevant app functionality."),t("td",null,[t("strong",null,"N/A")])],-1),$=t("td",null,"Notifications",-1),tt=t("td",null,"Stores details about in-app notifications.",-1),et=e("Module Bar"),ot=e(" and "),lt=e("Sidebar"),st=e("Notifications"),nt=t("td",null,"Operations",-1),it=t("td",null,[e("Stores information required for Operations, which are a part of "),t("a",{href:"#flows"},"Flows"),e(".")],-1),at=e("Operations"),ct=e("Operations"),dt=t("td",null,"Panels",-1),rt=t("td",null,[e("This stores information about individual analytics panels, which are displayed on "),t("a",{href:"#dashboards"},"Dashboards"),e(".")],-1),ut=e("Insights"),ht=t("td",null,[t("strong",null,"N/A")],-1),_t=t("td",null,"Permissions",-1),pt=t("td",null,"This stores the access permissions configured for roles.",-1),ft=e("Users, Roles & Permissions"),mt=e("Permissions"),gt=t("td",null,"Presets",-1),yt=t("td",null,"This stores details for presets and bookmarks.",-1),vt=e("Presents & Bookmarks"),wt=e("Presets"),bt=t("td",null,"Relations",-1),St=t("td",null,"This stores information about relationships between collections.",-1),Ct=e("Relationships"),Tt=e("Relations"),kt=t("td",null,"Revisions",-1),At=t("td",null,"Revisions are changes/edits made to Items. Directus keeps track of edits made, so you\u2019re able to revert to a previous state at will.",-1),Dt=e("Revert an Item"),Ft=e("Revisions"),It=t("td",null,"Roles",-1),xt=t("td",null,"Stores information about each role created.",-1),Nt=e("Users, Roles, and Permissions"),Pt=e("Roles"),Mt=t("tr",null,[t("td",null,"Sessions"),t("td",null,"Stores information about each user session, for system purposes."),t("td",null,[t("strong",null,"N/A")]),t("td",null,[t("strong",null,"N/A")])],-1),Ot=t("td",null,"Settings",-1),Rt=t("td",null,[e("Stores all configurations made within "),t("strong",null,"Settings > Project Settings"),e(".")],-1),jt=e("Project Settings"),Bt=e("settings"),Lt=t("td",null,"Shares",-1),Ut=t("td",null,"Stores all information regarding data shares.",-1),Et=e("Data Sharing"),Ht=t("td",null,null,-1),Vt=t("td",null,"Users",-1),qt=t("td",null,"Stores information about each user within the platform.",-1),Wt=e("User Directory"),Kt=e("Users"),Qt=t("td",null,"Webhooks",-1),Yt=t("td",null,"Stores all information about configured webhooks.",-1),Gt=e("Webhooks"),zt=e("Webhooks"),Jt=t("h2",{id:"create-a-collection",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#create-a-collection"},"#"),e(" Create a Collection")],-1),Xt=t("video",{title:"Create a Collection",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:`https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/create-a-collection-20220805A.mp4
+`,type:"video/mp4"})],-1),Zt=t("p",null,"To create a collection, follow these steps.",-1),$t=t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(", click "),t("span",{mi:"",btn:""},"add"),e(" in the page header, and a drawer will open.")],-1),te=t("li",null,[e("Enter a unique "),t("strong",null,"Collection Name"),e(". This cannot be modified later, but can be translated."),t("br"),e(" This is used as the data table key, API collection key, and default collection name.")],-1),ee=e("Optional: Make any other configurations as desired. "),oe=t("li",null,[t("strong",null,"Singleton"),e(" \u2014 Toggles whether the collection is a "),t("a",{href:"#collection-setup"},"Singleton"),e(".")],-1),le=t("li",null,[t("strong",null,"Primary Key Field"),e(" \u2014 Sets the name of the primary key field, defaults to "),t("code",null,"id"),e(".")],-1),se=t("strong",null,"Type",-1),ne=e(" \u2014 Sets the "),ie=e("type of ID"),ae=e(" to use for this collection."),ce=t("li",null,[e("Click "),t("span",{mi:"",btn:""},"arrow_forward"),e(" to confirm.")],-1),de=t("li",null,[e("Enable and rename the other Optional System Fields as desired: "),t("ul",null,[t("li",null,[t("strong",null,"Status"),e(" \u2014 Stores item status.")]),t("li",null,[t("strong",null,"Sort"),e(" \u2014 Adds a field which enables drag-and-drop sorting of items.")]),t("li",null,[t("strong",null,"Created On"),e(" \u2014 Logs the date an item was created.")]),t("li",null,[t("strong",null,"Created By"),e(" \u2014 Logs the user that created this item.")]),t("li",null,[t("strong",null,"Updated On"),e(" \u2014 Logs the date an item was last updated.")]),t("li",null,[t("strong",null,"Updated By"),e(" \u2014 Stores the last user to edit the file.")])])],-1),re=t("li",null,[e("Click "),t("span",{mi:"",btn:""},"check"),e(" to confirm and create the collection.")],-1),ue=t("div",{class:"danger hint"},[t("div",{class:"hint-title"},"Immutable Keys"),t("p",null,[e("The collection name from step two cannot be modified after collection creation. However, you can override how it is displayed with "),t("a",{href:"#collection-setup"},"Collection Naming Translations"),e(".")])],-1),he=t("div",{class:"warning hint"},[t("div",{class:"hint-title"},"Composite Keys"),t("p",null,"Directus does not currently support composite keys. If your project uses composite keys, you will need to make an adjustment to the data model.")],-1),_e=t("div",{class:"warning hint"},[t("div",{class:"hint-title"},"SQL Views"),t("p",null,"Directus does not currently support creation of virtual tables via SQL Views.")],-1),pe=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Database Tables"),t("p",null,[e("Remember, a collection is simply a database table. Therefore, you can import or create a table directly in the database and it will automatically appear within your Directus project. The first time you manage that table, a "),t("code",null,"directus_collections"),e(" record will be created with default values.")])],-1),fe=t("h2",{id:"toggle-collection-visibility",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#toggle-collection-visibility"},"#"),e(" Toggle Collection Visibility")],-1),me=t("video",{title:"Hide a Collection",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/toggle-collection-visibility-20220805A.mp4",type:"video/mp4"})],-1),ge=t("p",null,"To toggle whether a collection is hidden by default in the Content Module, follow these steps.",-1),ye=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(".")]),t("li",null,[e("Click "),t("span",{mi:"",icon:""},"more_vert"),e(" to open the collection\u2019s Context Menu.")]),t("li",null,[e("Select "),t("strong",null,"View Content"),e(" or "),t("strong",null,"Make Collection Hidden"),e(" to adjust visibility as desired.")])],-1),ve={class:"tip hint"},we=e("Assuming a user has "),be=e("access permissions"),Se=e(", hidden collections can still be viewed. They must right-click on the Navigation Bar and choose "),Ce=t("span",{mi:"",icon:""},"visibility",-1),Te=e(),ke=t("strong",null,"Show Hidden Collections",-1),Ae=e("."),De=t("h2",{id:"create-a-folder",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#create-a-folder"},"#"),e(" Create a Folder")],-1),Fe=t("video",{title:"Create a Folder",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/create-a-folder-20220805A.mp4",type:"video/mp4"})],-1),Ie=t("p",null,[e("Folders allow you to sub-nest and group how collections are displayed. This feature simply changes how the collections are displayed under "),t("strong",null,"Settings > Data Model"),e(" and in the Content Module. It has no impact on the data model. To create a folder, follow these steps.")],-1),xe=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(".")]),t("li",null,[e("Click "),t("span",{mi:"",btn:"",muted:""},"create_new_folder"),e(" in the page header.")]),t("li",null,"Set a folder key, which will also be used as the folder\u2019s name."),t("li",null,"Optional: Set the folder icon, color, note and translations as desired."),t("li",null,[e("Click "),t("strong",null,"Save"),e(" to create your folder.")])],-1),Ne=t("h2",{id:"toggle-folder-display",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#toggle-folder-display"},"#"),e(" Toggle Folder Display")],-1),Pe=t("video",{title:"Toggle Folder Display",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/toggle-folder-display-20220805A.mp4",type:"video/mp4"})],-1),Me=t("p",null,"To toggle folder display, follow these steps.",-1),Oe=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(".")]),t("li",null,[e("Click "),t("span",{mi:"",icon:""},"folder"),e(" on the desired collection to toggle the following displays: "),t("ul",null,[t("li",null,[t("strong",null,"Start Open")]),t("li",null,[t("strong",null,"Start Collapsed")]),t("li",null,[t("strong",null,"Always Open")])])])],-1),Re=t("h2",{id:"sort-and-nest-collections",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#sort-and-nest-collections"},"#"),e(" Sort and Nest Collections")],-1),je=t("video",{title:"Configure a Collection",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/sort-and-nest-collections.mp4",type:"video/mp4"})],-1),Be=t("p",null,[e("To sort and nest collections in "),t("strong",null,"Settings > Data Model"),e(" and "),t("strong",null,"Content Module"),e(", follow these steps.")],-1),Le=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(".")]),t("li",null,[e("Click and drag "),t("span",{mi:"",icon:""},"drag_handle"),e(" to position collections as desired."),t("br"),e(" To nest a collection, drag below and to the right of an intended parent folder or collection.")])],-1),Ue=t("h2",{id:"configure-a-collection",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#configure-a-collection"},"#"),e(" Configure a Collection")],-1),Ee=t("video",{title:"Configure a Collection",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/configure-a-collection-20220805A.mp4",type:"video/mp4"})],-1),He=t("p",null,"To configure a collection, follow these steps.",-1),Ve=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model"),e(" and click the desired collection."),t("br"),e(" The collection\u2019s configuration page will open.")]),t("li",null,[e("Make configurations as desired. Configuration options are broken into six categories. "),t("ul",null,[t("li",null,[t("a",{href:"#fields-layout"},"Fields and Layout")]),t("li",null,[t("a",{href:"#collection-setup"},"Collection Setup")]),t("li",null,[t("a",{href:"#archive"},"Archive")]),t("li",null,[t("a",{href:"#sort-field"},"Sort")]),t("li",null,[t("a",{href:"#accountability"},"Accountability")]),t("li",null,[t("a",{href:"#duplication"},"Duplication")])])]),t("li",null,[e("Click "),t("span",{mi:"",btn:""},"check"),e(" to confirm.")])],-1),qe=t("h3",{id:"fields-%26-layout",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#fields-%26-layout"},"#"),e(" Fields & Layout")],-1),We=t("video",{title:"Fields and Layout",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/fields-and-layout-20220805A.mp4",type:"video/mp4"})],-1),Ke=e("This section allows you to create and configure fields, as well as configure how fields are displayed on the "),Qe=e("Item Details Page"),Ye=e(". To learn more, please see the documentation on "),Ge=e("fields"),ze=e("."),Je=t("h3",{id:"collection-setup",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#collection-setup"},"#"),e(" Collection Setup")],-1),Xe=t("video",{title:"Collection Setup",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/collection-setup-20220805A.mp4",type:"video/mp4"})],-1),Ze=t("p",null,"These controls allow you to modify how the collection is displayed within the Content Module.",-1),$e=t("li",null,[t("strong",null,"Collection Name"),e(" \u2014 Displays the collection\u2019s name, which cannot be modified. However, you can override the displayed name with Collection Naming Translations, shown lower on this list.")],-1),to=t("li",null,[t("strong",null,"Note"),e(" \u2014 Set a helpful note that explains the collection\u2019s purpose.")],-1),eo=t("li",null,[t("strong",null,"Icon"),e(" \u2014 Set an icon used throughout the app when referencing this collection.")],-1),oo=t("li",null,[t("strong",null,"Color"),e(" \u2014 Set a color for the icon, shown in the Navigation Bar and its page header.")],-1),lo=t("strong",null,"Display Template",-1),so=e(" \u2014 Create a "),no=e("Display Template"),io=e(" for the collection."),ao=t("li",null,[t("strong",null,"Hidden"),e(" \u2014 Toggle whether the collection should be globally hidden in the other app modules, even for admin users. You cannot hide collections for admins via permissions like other roles, so this comes in handy to tidy up the Content Module.")],-1),co=t("strong",null,"Singleton",-1),ro=e(" \u2014 Toggle to bypass the "),uo=e("Collection Page"),ho=e(" and take users to the "),_o=e("Item Details Page"),po=e("."),fo=t("strong",null,"Collection Naming Translations",-1),mo=e(" \u2014 Translate the collection name across multiple languages. When the default language is changed in "),go=e("Project Settings"),yo=e(" or "),vo=e("User Details Page"),wo=e(", the relevant translation, if any exists, will be used throughout the app."),bo={class:"tip hint"},So=t("div",{class:"hint-title"},"Collection Naming Translations",-1),Co=e("By default, Directus uses the "),To=e("Title Formatter"),ko=e(" to display collection keys as human readable names, but you can also use translations to explicitly rename more technical table keys."),Ao=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"What's a Singleton?"),t("p",null,[e("A collection that only contains one single item. For example, a website\u2019s "),t("strong",null,"About Us"),e(" page.")])],-1),Do=t("h3",{id:"archive",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#archive"},"#"),e(" Archive")],-1),Fo=t("video",{title:"Archive",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/archive-20220805A.mp4",type:"video/mp4"})],-1),Io=t("p",null,[e("Selects a field to handle archiving items. This provides a "),t("em",null,"soft-delete"),e(" functionality for items in a collection. Archived items will still exist in the collection and database, but are filtered within the Data Studio. To configure an archive field, set the following four input fields as desired.")],-1),xo=t("li",null,[t("strong",null,"Archive Field"),e(" \u2014 Selects the archive field from a dropdown menu.")],-1),No=t("strong",null,"Archive App Filter",-1),Po=e(" \u2014 Toggles whether app users can "),Mo=e("filter for archived items"),Oo=e("."),Ro=t("strong",null,"Archive Value",-1),jo=e(" \u2014 A value that is assigned to the field when an item is "),Bo=e("archived"),Lo=e("."),Uo=t("strong",null,"Unarchive Value",-1),Eo=e(" \u2014 A value that is assigned to the field when an item is "),Ho=e("unarchived"),Vo=e("."),qo=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Automatic Setup"),t("p",null,[e("When you "),t("a",{href:"#create-a-collection"},"create a collection"),e(", you have the option to create an optional Status Field. If you choose to include this field, the collection\u2019s archive settings will be automatically configured for you.")])],-1),Wo=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Archive Field Values"),t("p",null,"The archive fields can contain any number of additional values besides the archived and unarchived values defined above.")],-1),Ko=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Archived Item Management via API"),t("p",null,"Archived items are hidden in the app by default, but they are still returned normally via the API unless explicitly filtered out. This gives you the flexibility to manage archived items however you want when working with the API.")],-1),Qo=t("h3",{id:"sort-field",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#sort-field"},"#"),e(" Sort Field")],-1),Yo=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Batch Edit Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/manually-sort-items-20220415A.mp4",type:"video/mp4"})],-1),Go=e("The sort feature enables users to "),zo=e("manually sort Items"),Jo=e(" within the Data Studio. This is typically shown on the "),Xo=t("strong",null,"Content Module > Collection Page",-1),Zo=e(". It can also be used for sorting items within "),$o=e("Junction Collections"),tl=e(". A standard field, configured with an "),el=t("code",null,"INTEGER",-1),ol=e(" data type, is required. As shown in the video, fields which cannot serve as sort fields will be grayed out and unselectable in the Sort Field dropdown."),ll=t("p",null,[t("strong",null,"Sort Field"),e(" \u2014 Select a field to custom sort and order items. Click "),t("strong",null,"Deselect"),e(" to disable.")],-1),sl=t("p",null,"To configure a sort field, follow these steps.",-1),nl=e("Create a Field"),il=e(" with an "),al=t("code",null,"INTEGER",-1),cl=e(" data type."),dl=t("li",null,[e("Choose a field from the dropdown under "),t("strong",null,"Settings > Data Model > [Collection] > Sort"),e(".")],-1),rl=t("li",null,[e("Click "),t("span",{mi:"",btn:""},"check"),e(" to confirm.")],-1),ul=e("Once you sort field is configured, you may want to learn how to "),hl=e("manually sort Items"),_l=e("."),pl={class:"tip hint"},fl=t("div",{class:"hint-title"},"Automatic Setup",-1),ml=e("When you "),gl=e("create a Collection"),yl=e(", you have the option of creating a "),vl=t("strong",null,"Sort",-1),wl=e(" field. If you choose to include this field, the collection\u2019s sort settings will automatically be configured for you."),bl=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Interface Sorting"),t("p",null,[e("To configure manual sorting within a relational Interface (e.g., M2M, O2M, or M2A), configure as above, but also set the "),t("strong",null,"Sort Field"),e(" within the relationship section of the field\u2019s configuration drawer.")])],-1),Sl=t("div",{class:"tip hint"},[t("div",{class:"hint-title"},"Configure to Hidden"),t("p",null,[e("You can also set this field to be "),t("strong",null,"Hidden"),e(" so it doesn\u2019t show up within the Item Details Page.")])],-1),Cl=t("h3",{id:"accountability",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#accountability"},"#"),e(" Accountability")],-1),Tl=t("video",{title:"Accountability",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/acountability-20220805A.mp4",type:"video/mp4"})],-1),kl=e("By default, your Directus Project tracks all "),Al=e("activity"),Dl=e(" and "),Fl=e("revisions"),Il=e(" for collections. However, you can override this and choose what data is tracked."),xl=t("ul",null,[t("li",null,[t("strong",null,"Activity & Revision Tracking"),e(" \u2014 The following options are supported: "),t("ul",null,[t("li",null,[t("strong",null,"Track Activity & Revisions")]),t("li",null,[t("strong",null,"Only Track Activity")]),t("li",null,[t("strong",null,"Do Not Track Anything")])])])],-1),Nl={class:"tip hint"},Pl=t("div",{class:"hint-title"},"Accountability vs. Telemetry",-1),Ml=e("Accountability is a log of "),Ol=t("em",null,"who does what",-1),Rl=e(" in your project. It is for your team\u2019s own use. This is different from "),jl=e("telemetry"),Bl=e(", which is configured under "),Ll=e("environment variables"),Ul=e("."),El=t("h3",{id:"duplication",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#duplication"},"#"),e(" Duplication")],-1),Hl=t("video",{title:"Duplication",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/duplicate-20220805A.mp4",type:"video/mp4"})],-1),Vl=t("p",null,[e("The "),t("strong",null,"Save as Copy"),e(" option on the Item Details Page offers a way to effectively duplicate the current item. Since there may be unique or relational data within the item, it\u2019s important to control exactly what will be copied. Duplication lets you configure which parent & relational field values will be copied when you use "),t("strong",null,"Save as Copy"),e(" on an item.")],-1),ql=t("ul",null,[t("li",null,[t("strong",null,"Item Duplication Fields"),e(" \u2014 Check the field(s) to copy values for when duplicating an item.")])],-1),Wl=t("h2",{id:"delete-a-collection",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#delete-a-collection"},"#"),e(" Delete a Collection")],-1),Kl=t("video",{title:"Delete a Collection",autoplay:"",playsinline:"",muted:"",loop:"",controls:""},[t("source",{src:"https://cdn.directus.io/docs/v9/configuration/data-model/collections/collections-20220805/delete-a-collection-20220805A.mp4",type:"video/mp4"})],-1),Ql=t("p",null,"To delete a collection, follow these steps.",-1),Yl=t("ol",null,[t("li",null,[e("Navigate to "),t("strong",null,"Settings > Data Model > [Collection Name]"),e(".")]),t("li",null,[e("Click "),t("span",{mi:"",btn:"",dngr:""},"delete"),e(" in the page header.")]),t("li",null,[e("Confirm this decision by clicking "),t("strong",null,"Delete"),e(" in the dialog.")])],-1),Gl=t("div",{class:"danger hint"},[t("p",null,"This action is permanent and irreversible. Please proceed with caution.")],-1),$l="Collections",ts=!1,es={name:"collections",setup(zl,{expose:a}){const n={title:"Collections",modularExtension:!1};return a({frontmatter:n}),(Jl,Xl)=>{const l=i("router-link"),c=i("docs-wrapper");return d(),r(c,{frontmatter:n},{default:o(()=>[t("div",u,[h,_,p,t("p",null,[f,s(l,{to:"/docs/app/content"},{default:o(()=>[m]),_:1}),g]),y,v,w,b,S,t("table",null,[C,t("tbody",null,[t("tr",null,[T,k,t("td",null,[s(l,{to:"/docs/configuration/activity-log"},{default:o(()=>[A]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/activity"},{default:o(()=>[D]),_:1})])]),t("tr",null,[F,I,t("td",null,[s(l,{to:"/docs/configuration/data-model/collections"},{default:o(()=>[x]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/collections"},{default:o(()=>[N]),_:1})])]),t("tr",null,[P,M,t("td",null,[s(l,{to:"/docs/app/insights"},{default:o(()=>[O]),_:1})]),R]),t("tr",null,[j,B,t("td",null,[s(l,{to:"/docs/configuration/data-model/fields/"},{default:o(()=>[L]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/fields"},{default:o(()=>[U]),_:1})])]),t("tr",null,[E,H,t("td",null,[s(l,{to:"/docs/app/file-library"},{default:o(()=>[V]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/files"},{default:o(()=>[q]),_:1})])]),t("tr",null,[W,K,t("td",null,[s(l,{to:"/docs/configuration/flows"},{default:o(()=>[Q]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/flows"},{default:o(()=>[Y]),_:1})])]),t("tr",null,[G,z,t("td",null,[s(l,{to:"/docs/app/file-library#folders"},{default:o(()=>[J]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/folders"},{default:o(()=>[X]),_:1})])]),Z,t("tr",null,[$,tt,t("td",null,[s(l,{to:"/docs/app/overview#_1-module-bar"},{default:o(()=>[et]),_:1}),ot,s(l,{to:"/docs/app/overview#_4-sidebar"},{default:o(()=>[lt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/notifications"},{default:o(()=>[st]),_:1})])]),t("tr",null,[nt,it,t("td",null,[s(l,{to:"/docs/configuration/flows"},{default:o(()=>[at]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/operations.md"},{default:o(()=>[ct]),_:1})])]),t("tr",null,[dt,rt,t("td",null,[s(l,{to:"/docs/app/insights"},{default:o(()=>[ut]),_:1})]),ht]),t("tr",null,[_t,pt,t("td",null,[s(l,{to:"/docs/configuration/users-roles-permissions"},{default:o(()=>[ft]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/permissions"},{default:o(()=>[mt]),_:1})])]),t("tr",null,[gt,yt,t("td",null,[s(l,{to:"/docs/configuration/presets-bookmarks"},{default:o(()=>[vt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/presets"},{default:o(()=>[wt]),_:1})])]),t("tr",null,[bt,St,t("td",null,[s(l,{to:"/docs/configuration/data-model/relationships"},{default:o(()=>[Ct]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/relations"},{default:o(()=>[Tt]),_:1})])]),t("tr",null,[kt,At,t("td",null,[s(l,{to:"/docs/app/content/items#revert-an-item"},{default:o(()=>[Dt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/revisions"},{default:o(()=>[Ft]),_:1})])]),t("tr",null,[It,xt,t("td",null,[s(l,{to:"/docs/configuration/users-roles-permissions"},{default:o(()=>[Nt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/roles"},{default:o(()=>[Pt]),_:1})])]),Mt,t("tr",null,[Ot,Rt,t("td",null,[s(l,{to:"/docs/configuration/project-settings"},{default:o(()=>[jt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/settings"},{default:o(()=>[Bt]),_:1})])]),t("tr",null,[Lt,Ut,t("td",null,[s(l,{to:"/docs/app/content/shares"},{default:o(()=>[Et]),_:1})]),Ht]),t("tr",null,[Vt,qt,t("td",null,[s(l,{to:"/docs/app/user-directory"},{default:o(()=>[Wt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/relations"},{default:o(()=>[Kt]),_:1})])]),t("tr",null,[Qt,Yt,t("td",null,[s(l,{to:"/docs/configuration/webhooks"},{default:o(()=>[Gt]),_:1})]),t("td",null,[s(l,{to:"/docs/reference/system/relations"},{default:o(()=>[zt]),_:1})])])])]),Jt,Xt,Zt,t("ol",null,[$t,te,t("li",null,[ee,t("ul",null,[oe,le,t("li",null,[se,ne,s(l,{to:"/docs/configuration/data-model/fields/#keys-and-ids"},{default:o(()=>[ie]),_:1}),ae])])]),ce,de,re]),ue,he,_e,pe,fe,me,ge,ye,t("div",ve,[t("p",null,[we,s(l,{to:"/docs/configuration/users-roles-permissions"},{default:o(()=>[be]),_:1}),Se,Ce,Te,ke,Ae])]),De,Fe,Ie,xe,Ne,Pe,Me,Oe,Re,je,Be,Le,Ue,Ee,He,Ve,qe,We,t("p",null,[Ke,s(l,{to:"/docs/app/content/items"},{default:o(()=>[Qe]),_:1}),Ye,s(l,{to:"/docs/configuration/data-model/fields/"},{default:o(()=>[Ge]),_:1}),ze]),Je,Xe,Ze,t("ul",null,[$e,to,eo,oo,t("li",null,[lo,so,s(l,{to:"/docs/app/display-templates"},{default:o(()=>[no]),_:1}),io]),ao,t("li",null,[co,ro,s(l,{to:"/docs/app/content/collections"},{default:o(()=>[uo]),_:1}),ho,s(l,{to:"/docs/app/content/items"},{default:o(()=>[_o]),_:1}),po]),t("li",null,[fo,mo,s(l,{to:"/docs/configuration/project-settings#general"},{default:o(()=>[go]),_:1}),yo,s(l,{to:"/docs/app/user-directory#user-details-page"},{default:o(()=>[vo]),_:1}),wo])]),t("div",bo,[So,t("p",null,[Co,s(l,{to:"/docs/getting-started/glossary#title-formatter"},{default:o(()=>[To]),_:1}),ko])]),Ao,Do,Fo,Io,t("ul",null,[xo,t("li",null,[No,Po,s(l,{to:"/docs/app/content/collections#view-archived-items"},{default:o(()=>[Mo]),_:1}),Oo]),t("li",null,[Ro,jo,s(l,{to:"/docs/app/content/items#archive-an-item"},{default:o(()=>[Bo]),_:1}),Lo]),t("li",null,[Uo,Eo,s(l,{to:"/docs/app/content/items#archive-an-item"},{default:o(()=>[Ho]),_:1}),Vo])]),qo,Wo,Ko,Qo,Yo,t("p",null,[Go,s(l,{to:"/docs/app/content/collections#manually-sort-items"},{default:o(()=>[zo]),_:1}),Jo,Xo,Zo,s(l,{to:"/docs/getting-started/glossary#junction-collections"},{default:o(()=>[$o]),_:1}),tl,el,ol]),ll,sl,t("ol",null,[t("li",null,[s(l,{to:"/docs/configuration/data-model/fields/#create-a-field-standard"},{default:o(()=>[nl]),_:1}),il,al,cl]),dl,rl]),t("p",null,[ul,s(l,{to:"/docs/app/content/collections#manually-sort-items"},{default:o(()=>[hl]),_:1}),_l]),t("div",pl,[fl,t("p",null,[ml,s(l,{to:"/docs/configuration/data-model/collections#create-a-collection"},{default:o(()=>[gl]),_:1}),yl,vl,wl])]),bl,Sl,Cl,Tl,t("p",null,[kl,s(l,{to:"/docs/reference/system/activity"},{default:o(()=>[Al]),_:1}),Dl,s(l,{to:"/docs/reference/system/revisions"},{default:o(()=>[Fl]),_:1}),Il]),xl,t("div",Nl,[Pl,t("p",null,[Ml,Ol,Rl,s(l,{to:"/docs/self-hosted/config-options#telemetry"},{default:o(()=>[jl]),_:1}),Bl,s(l,{to:"/docs/self-hosted/config-options#telemetry"},{default:o(()=>[Ll]),_:1}),Ul])]),El,Hl,Vl,ql,Wl,Kl,Ql,Yl,Gl])]),_:1})}}};export{es as default,ts as modularExtension,$l as title};

package/dist/assets/{collections.74218877.js → collections.2fa0dd8e.js}

@@ -1,2 +1,2 @@
-import{a as l,o as d,b as r,w as o,g as t,e as n,B as e}from"./runtime-core.esm-bundler.e3d5f5b7.js";const h={class:"markdown-body"},u=t("blockquote",null,[t("p",null,"The Collection Page displays all Items within a Collection and comes with highly configurable Layouts for browsing, visualizing, and managing these Items.")],-1),p={class:"tip hint"},m=t("div",{class:"hint-title"},"Before You Begin",-1),_=e("To use the Collection Page, you will need to know about "),g=e("Collections"),y=e(", "),f=e("Items"),v=e(" and "),b=e("Fields"),w=e("."),I=t("h2",{id:"adjust-page-layout",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#adjust-page-layout"},"#"),e(" Adjust Page Layout")],-1),C=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Layouts"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/adjust-page-layout-20220415A.mp4",type:"video/mp4"})],-1),k=e("Layouts determine how you view or interact with Items in a Collection. Whether your Collection contains blog posts, project management tasks, geo-coordinates, temporal data or beyond; Layouts present Items in a more human-friendly way. "),A=e("Learn More"),T=t("h2",{id:"search-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#search-items"},"#"),e(" Search Items")],-1),x=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Search Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/search-items-20220419A.mp4",type:"video/mp4"})],-1),L=t("p",null,[e("Find all Items with one or more Fields containing your searched value, excluding any Items which have been "),t("a",{href:"#filter-items"},"filtered out"),e(". To search through a Collection\u2019s Items, follow these steps.")],-1),S=t("ol",null,[t("li",null,"Navigate to the Content Module and select the desired Collection."),t("li",null,[e("Select "),t("span",{mi:"",icon:""},"search"),e(" in the Page Header and a search bar will appear.")]),t("li",null,"Type in the value to search for.")],-1),P=t("h2",{id:"filter-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#filter-items"},"#"),e(" Filter Items")],-1),F=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Filter Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/filter-items-2022019A.mp4",type:"video/mp4"})],-1),B=e("Filters allow you to conditionally select Items from a Collection. Use-cases include customizing Item search results, restricting Item access permissions for specific Users or Roles, building dashboard analytics with the Insights module, and more. To Learn More, see our guide on "),E=e("Filters"),M=e("."),D=t("h2",{id:"manually-sort-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#manually-sort-items"},"#"),e(" Manually Sort Items")],-1),N=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Batch Edit Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/manually-sort-items-20220415A.mp4",type:"video/mp4"})],-1),j=e("Drag and drop Items to custom sort them as desired. This is only possible on certain Layouts, such as the default "),q=e("Table Layout"),V=e(". To sort a Collection\u2019s Items, follow these steps."),z=e("Be sure "),U=e("a sort field"),O=e(" has been configured under "),R=t("strong",null,"\u201CSettings > Data Model > Collection\u201D",-1),H=e("."),W=t("br",null,null,-1),Y=t("em",null,"(Shown in the video)",-1),G=t("li",null,"Navigate to the Content Module and select the desired Collection.",-1),J=t("li",null,[e("In the Sidebar, be sure a "),t("a",{href:"#adjust-page-layout"},"Layout"),e(" is chosen that supports manual sorting.")],-1),K=t("li",null,[e("Enable manual sorting: "),t("ul",null,[t("li",null,[e("For the Table Layout, toggle "),t("span",{mi:"",icon:""},"sort"),e(" in the configured Sort column.")])])],-1),Q=t("li",null,"Drag Items by their handle into a new position.",-1),X={class:"warning hint"},Z=t("div",{class:"hint-title"},"Manual Sorting Requires Configuration",-1),$=e("Only available if a "),tt=e("sort field"),et=e(" has been configured."),ot={class:"tip hint"},st=e("Sorting saves a value in a "),nt=e("Sort Field"),it=e(". This value is used to return data in a custom order. This means that while the values in this Sort Field do get updated and modified, values in other Fields are not changed."),lt=t("h2",{id:"automatically-sort-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#automatically-sort-items"},"#"),e(" Automatically Sort Items")],-1),at=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Automatically Sort Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/automatically-sort-items-20220415A.mp4",type:"video/mp4"})],-1),ct=e("Sort Items alphabetically or numerically, in ascending or descending order. Sorting is not possible on certain Layouts, such as the Map Layout. Layouts that do support automatic sorting have controls in slightly different locations. To learn more, see "),dt=e("Layouts"),rt=e("."),ht=t("div",{class:"tip hint"},[t("p",null,"Automatic sorting is a non-destructive action which does not change your data.")],-1),ut=t("h2",{id:"view-archived-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#view-archived-items"},"#"),e(" View Archived Items")],-1),pt=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"View Archived Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/view-archived-items.mp4",type:"video/mp4"})],-1),mt=e("The no-code app allows you to hide archived Items, display them alongside other Items, or display archived Items only. To learn how to archive an Item, see our guide on the "),_t=e("Item Page"),gt=e(". To change whether an archived Item is displayed, follow these steps."),yt=t("ol",null,[t("li",null,"Navigate to the Content Module and select the desired Collection."),t("li",null,[e("Click "),t("strong",null,"\u201CArchive\u201D"),e(" in the Sidebar.")]),t("li",null,[e("Choose the desired view: "),t("ul",null,[t("li",null,[t("strong",null,"\u201CShow Items\u201D")]),t("li",null,[t("strong",null,"\u201CShow Archived Items\u201D")]),t("li",null,[t("strong",null,"\u201CShow Items + Archived Items\u201D")])])])],-1),ft={class:"warning hint"},vt=t("div",{class:"hint-title"},"Archiving Requires Configuration",-1),bt=e("Only available if an "),wt=e("Archive field"),It=e(" has been configured."),Ct=t("h2",{id:"create-presets-and-bookmarks",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#create-presets-and-bookmarks"},"#"),e(" Create Presets and Bookmarks")],-1),kt=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Create Presets and Bookmarks"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/presets-and-bookmarks-20220415A.mp4",type:"video/mp4"})],-1),At=e("Save how a Collection Page looks so that you can return to the exact same view later, including details such as the Layout, searches, filters, sorting, ordering, etc. To learn more, see our guide on "),Tt=e("Presets and Bookmarks"),xt=e("."),Lt=t("h2",{id:"import-%2F-export-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#import-%2F-export-items"},"#"),e(" Import / Export Items")],-1),St=t("p",null,[t("img",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/imports-exports-20220416A.webp",alt:"Import and Export Items"})],-1),Pt=e("The Content, User Directory and File Library modules allow importing and exporting of multiple Items stored as files. This makes it quick and easy to handle tasks like uploading and downloading new customer information; pulling down sales data for transformation, reports, analysis, and beyond. To learn more, see how to "),Ft=e("Import and Export Items"),Bt=e(" in file format."),Et=t("h2",{id:"batch-delete%2C-archive-or-edit-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#batch-delete%2C-archive-or-edit-items"},"#"),e(" Batch Delete, Archive or Edit Items")],-1),Mt=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Batch Edit Items"},[t("source",{src:`https://cdn.directus.io/docs/v9/app-guide/content/content-items/content-items-20220415A/batch-edit-items-20220415A.mp4
-`,type:"video/mp4"})],-1),Dt=t("p",null,"It is possible to delete, archive, or edit multiple Items at once from the Collection Page. Deletion will permanently delete Items from the database, this cannot be reverted. When batch editing, the Item Page opens, allowing you to make the same edit across multiple Items. Follow these steps to batch delete, archive, or edit Items.",-1),Nt=t("li",null,"Navigate to the Content Module and select the desired Collection.",-1),jt=e("Choose a "),qt=e("Layout"),Vt=e(" that supports multiple Item selection from the Sidebar."),zt=t("br",null,null,-1),Ut=e(" (e.g. The Table or Card Layout)"),Ot=t("li",null,[e("Click the Items you wish to select: "),t("ul",null,[t("li",null,[t("strong",null,"Table Layout:"),e(" Click "),t("span",{mi:"",icon:""},"check_box_outline_blank"),e(" in the left-most column.")]),t("li",null,[t("strong",null,"Card Layout:"),e(" Click "),t("span",{mi:"",icon:""},"radio_button_unchecked"),e(" in the upper left-hand corner of each Card.")])])],-1),Rt=t("p",null,[e("Once Items are selected, the following buttons will appear in the Page Header: "),t("span",{mi:"",btn:"",muted:""},"delete"),t("span",{mi:"",btn:"",muted:""},"archive"),e(),t("span",{mi:"",btn:"",muted:""},"edit")],-1),Ht=t("p",null,[t("strong",null,"Delete"),t("br"),e(" 4. Click "),t("span",{mi:"",btn:"",dngr:""},"delete"),e(" in the header and a popup will appear."),t("br"),e(" 5. Click "),t("strong",null,"\u201CDelete\u201D"),e(" to confirm the action.")],-1),Wt=t("p",null,[t("strong",null,"Archive"),t("br"),e(" 4. Click "),t("span",{mi:"",btn:"",muted:""},"archive"),e(" in the header and a popup will appear."),t("br"),e(" 5. Click "),t("strong",null,"\u201CDelete\u201D"),e(" to confirm the action.")],-1),Yt=t("p",null,[t("strong",null,"Edit"),t("br"),e(" 4. Click "),t("span",{mi:"",btn:"",muted:""},"edit"),e(" in the header and the Item Page will open."),t("br"),e(" 5. Update Item details as desired."),t("br"),e(" 6. Click "),t("span",{mi:"",btn:""},"check"),e(" to confirm batch edits on all Items.")],-1),Xt="Collection Page",Zt=!1,$t="The Collection Page displays all Items within a Collection and comes with highly configurable Layouts for browsing, visualizing, and managing these Items.",te="6 min read",ee={name:"collections",setup(Gt,{expose:a}){const i={title:"Collection Page",modularExtension:!1,description:"The Collection Page displays all Items within a Collection and comes with highly configurable Layouts for browsing, visualizing, and managing these Items.",readTime:"6 min read"};return a({frontmatter:i}),(Jt,Kt)=>{const s=l("router-link"),c=l("docs-wrapper");return d(),r(c,{frontmatter:i},{default:o(()=>[t("div",h,[u,t("div",p,[m,t("p",null,[_,n(s,{to:"/docs/getting-started/glossary#collections"},{default:o(()=>[g]),_:1}),y,n(s,{to:"/docs/getting-started/glossary#items"},{default:o(()=>[f]),_:1}),v,n(s,{to:"/docs/getting-started/glossary#fields"},{default:o(()=>[b]),_:1}),w])]),I,C,t("p",null,[k,n(s,{to:"/docs/app/layouts"},{default:o(()=>[A]),_:1})]),T,x,L,S,P,F,t("p",null,[B,n(s,{to:"/docs/app/filters"},{default:o(()=>[E]),_:1}),M]),D,N,t("p",null,[j,n(s,{to:"/docs/app/layouts#table-layout"},{default:o(()=>[q]),_:1}),V]),t("ol",null,[t("li",null,[z,n(s,{to:"/docs/configuration/data-model/collections#sort-field"},{default:o(()=>[U]),_:1}),O,R,H,W,Y]),G,J,K,Q]),t("div",X,[Z,t("p",null,[$,n(s,{to:"/docs/configuration/data-model/collections#sort-field"},{default:o(()=>[tt]),_:1}),et])]),t("div",ot,[t("p",null,[st,n(s,{to:"/docs/reference/query#sort"},{default:o(()=>[nt]),_:1}),it])]),lt,at,t("p",null,[ct,n(s,{to:"/docs/app/layouts"},{default:o(()=>[dt]),_:1}),rt]),ht,ut,pt,t("p",null,[mt,n(s,{to:"/docs/app/content/items#archive-an-item"},{default:o(()=>[_t]),_:1}),gt]),yt,t("div",ft,[vt,t("p",null,[bt,n(s,{to:"/docs/configuration/data-model/collections#archive"},{default:o(()=>[wt]),_:1}),It])]),Ct,kt,t("p",null,[At,n(s,{to:"/docs/configuration/presets-bookmarks"},{default:o(()=>[Tt]),_:1}),xt]),Lt,St,t("p",null,[Pt,n(s,{to:"/docs/app/import-export"},{default:o(()=>[Ft]),_:1}),Bt]),Et,Mt,Dt,t("ol",null,[Nt,t("li",null,[jt,n(s,{to:"/docs/app/layouts"},{default:o(()=>[qt]),_:1}),Vt,zt,Ut]),Ot]),Rt,Ht,Wt,Yt])]),_:1})}}};export{ee as default,$t as description,Zt as modularExtension,te as readTime,Xt as title};
+import{a as l,o as d,b as r,w as o,l as t,e as n,E as e}from"./runtime-core.esm-bundler.32cac88a.js";const h={class:"markdown-body"},u=t("blockquote",null,[t("p",null,"The Collection Page displays all Items within a Collection and comes with highly configurable Layouts for browsing, visualizing, and managing these Items.")],-1),m={class:"tip hint"},p=t("div",{class:"hint-title"},"Before You Begin",-1),_=e("To use the Collection Page, you will need to know about "),g=e("Collections"),y=e(", "),f=e("Items"),v=e(" and "),b=e("Fields"),w=e("."),I=t("h2",{id:"adjust-page-layout",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#adjust-page-layout"},"#"),e(" Adjust Page Layout")],-1),C=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Layouts"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/adjust-page-layout-20220415A.mp4",type:"video/mp4"})],-1),k=e("Layouts determine how you view or interact with Items in a Collection. Whether your Collection contains blog posts, project management tasks, geo-coordinates, temporal data or beyond; Layouts present Items in a more human-friendly way. "),A=e("Learn More"),T=t("h2",{id:"search-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#search-items"},"#"),e(" Search Items")],-1),x=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Search Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/search-items-20220419A.mp4",type:"video/mp4"})],-1),L=t("p",null,[e("Find all Items with one or more Fields containing your searched value, excluding any Items which have been "),t("a",{href:"#filter-items"},"filtered out"),e(". To search through a Collection\u2019s Items, follow these steps.")],-1),S=t("ol",null,[t("li",null,"Navigate to the Content Module and select the desired Collection."),t("li",null,[e("Select "),t("span",{mi:"",icon:""},"search"),e(" in the Page Header and a search bar will appear.")]),t("li",null,"Type in the value to search for.")],-1),P=t("h2",{id:"filter-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#filter-items"},"#"),e(" Filter Items")],-1),B=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Filter Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/filter-items-2022019A.mp4",type:"video/mp4"})],-1),F=e("Filters allow you to conditionally select Items from a Collection. Use-cases include customizing Item search results, restricting Item access permissions for specific Users or Roles, building dashboard analytics with the Insights module, and more. To Learn More, see our guide on "),E=e("Filters"),M=e("."),N=t("h2",{id:"manually-sort-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#manually-sort-items"},"#"),e(" Manually Sort Items")],-1),D=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Batch Edit Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/manually-sort-items-20220415A.mp4",type:"video/mp4"})],-1),j=e("Drag and drop Items to custom sort them as desired. This is only possible on certain Layouts, such as the default "),q=e("Table Layout"),V=e(". To sort a Collection\u2019s Items, follow these steps."),z=e("Be sure "),U=e("a sort field"),O=e(" has been configured under "),R=t("strong",null,"\u201CSettings > Data Model > Collection\u201D",-1),H=e("."),W=t("br",null,null,-1),Y=t("em",null,"(Shown in the video)",-1),G=t("li",null,"Navigate to the Content Module and select the desired Collection.",-1),J=t("li",null,[e("In the Sidebar, be sure a "),t("a",{href:"#adjust-page-layout"},"Layout"),e(" is chosen that supports manual sorting.")],-1),K=t("li",null,[e("Enable manual sorting: "),t("ul",null,[t("li",null,[e("For the Table Layout, toggle "),t("span",{mi:"",icon:""},"sort"),e(" in the configured Sort column.")])])],-1),Q=t("li",null,"Drag Items by their handle into a new position.",-1),X={class:"warning hint"},Z=t("div",{class:"hint-title"},"Manual Sorting Requires Configuration",-1),$=e("Only available if a "),tt=e("sort field"),et=e(" has been configured."),ot={class:"tip hint"},st=e("Sorting saves a value in a "),nt=e("Sort Field"),it=e(". This value is used to return data in a custom order. This means that while the values in this Sort Field do get updated and modified, values in other Fields are not changed."),lt=t("h2",{id:"automatically-sort-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#automatically-sort-items"},"#"),e(" Automatically Sort Items")],-1),at=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Automatically Sort Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/automatically-sort-items-20220415A.mp4",type:"video/mp4"})],-1),ct=e("Sort Items alphabetically or numerically, in ascending or descending order. Sorting is not possible on certain Layouts, such as the Map Layout. Layouts that do support automatic sorting have controls in slightly different locations. To learn more, see "),dt=e("Layouts"),rt=e("."),ht=t("div",{class:"tip hint"},[t("p",null,"Automatic sorting is a non-destructive action which does not change your data.")],-1),ut=t("h2",{id:"view-archived-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#view-archived-items"},"#"),e(" View Archived Items")],-1),mt=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"View Archived Items"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/view-archived-items.mp4",type:"video/mp4"})],-1),pt=e("The no-code app allows you to hide archived Items, display them alongside other Items, or display archived Items only. To learn how to archive an Item, see our guide on the "),_t=e("Item Page"),gt=e(". To change whether an archived Item is displayed, follow these steps."),yt=t("ol",null,[t("li",null,"Navigate to the Content Module and select the desired Collection."),t("li",null,[e("Click "),t("strong",null,"\u201CArchive\u201D"),e(" in the Sidebar.")]),t("li",null,[e("Choose the desired view: "),t("ul",null,[t("li",null,[t("strong",null,"\u201CShow Items\u201D")]),t("li",null,[t("strong",null,"\u201CShow Archived Items\u201D")]),t("li",null,[t("strong",null,"\u201CShow Items + Archived Items\u201D")])])])],-1),ft={class:"warning hint"},vt=t("div",{class:"hint-title"},"Archiving Requires Configuration",-1),bt=e("Only available if an "),wt=e("Archive field"),It=e(" has been configured."),Ct=t("h2",{id:"create-a-bookmark",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#create-a-bookmark"},"#"),e(" Create a Bookmark")],-1),kt=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Create Presets and Bookmarks"},[t("source",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/presets-and-bookmarks-20220415A.mp4",type:"video/mp4"})],-1),At=t("p",null,"Save how a Collection Page looks so that you can return to the exact same view later. This includes details such as the Layout, search queries, filters, custom sort & order, etc. To create a Bookmark from the Collection Page, follow these steps.",-1),Tt=t("ol",null,[t("li",null,"Navigate to the desired collection."),t("li",null,[e("Click "),t("span",{mi:"",btn:"",muted:""},"bookmark_outline"),e(" in the page header.")]),t("li",null,[e("Enter a "),t("strong",null,"Name"),e(),t("em",null,"(and optionally)"),e(" an "),t("strong",null,"Icon"),e(" and "),t("strong",null,"Color"),e(".")]),t("li",null,[e("Click "),t("strong",null,"Save"),e(" to confirm.")])],-1),xt=t("p",null,"Your Bookmark will appear in the Navigation Bar, under the associated Collection Page.",-1),Lt={class:"tip hint"},St=t("div",{class:"hint-title"},"Learn More",-1),Pt=e("To learn more, see our guide on "),Bt=e("Presets and Bookmarks"),Ft=e("."),Et=t("h2",{id:"import-%2F-export-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#import-%2F-export-items"},"#"),e(" Import / Export Items")],-1),Mt=t("p",null,[t("img",{src:"https://cdn.directus.io/docs/v9/app-guide/content/content-collections/content-collections-20220415A/imports-exports-20220416A.webp",alt:"Import and Export Items"})],-1),Nt=e("The Content, User Directory and File Library modules allow importing and exporting of multiple Items stored as files. This makes it quick and easy to handle tasks like uploading and downloading new customer information; pulling down sales data for transformation, reports, analysis, and beyond. To learn more, see how to "),Dt=e("Import and Export Items"),jt=e(" in file format."),qt=t("h2",{id:"batch-delete%2C-archive-or-edit-items",tabindex:"-1"},[t("a",{class:"header-anchor",href:"#batch-delete%2C-archive-or-edit-items"},"#"),e(" Batch Delete, Archive or Edit Items")],-1),Vt=t("video",{autoplay:"",playsinline:"",muted:"",loop:"",controls:"",title:"Batch Edit Items"},[t("source",{src:`https://cdn.directus.io/docs/v9/app-guide/content/content-items/content-items-20220415A/batch-edit-items-20220415A.mp4
+`,type:"video/mp4"})],-1),zt=t("p",null,"It is possible to delete, archive, or edit multiple Items at once from the Collection Page. Deletion will permanently delete Items from the database, this cannot be reverted. When batch editing, the Item Page opens, allowing you to make the same edit across multiple Items. Follow these steps to batch delete, archive, or edit Items.",-1),Ut=t("li",null,"Navigate to the Content Module and select the desired Collection.",-1),Ot=e("Choose a "),Rt=e("Layout"),Ht=e(" that supports multiple Item selection from the Sidebar."),Wt=t("br",null,null,-1),Yt=e(" (e.g. The Table or Card Layout)"),Gt=t("li",null,[e("Click the Items you wish to select: "),t("ul",null,[t("li",null,[t("strong",null,"Table Layout:"),e(" Click "),t("span",{mi:"",icon:""},"check_box_outline_blank"),e(" in the left-most column.")]),t("li",null,[t("strong",null,"Card Layout:"),e(" Click "),t("span",{mi:"",icon:""},"radio_button_unchecked"),e(" in the upper left-hand corner of each Card.")])])],-1),Jt=t("p",null,[e("Once Items are selected, the following buttons will appear in the Page Header: "),t("span",{mi:"",btn:"",muted:""},"delete"),t("span",{mi:"",btn:"",muted:""},"archive"),e(),t("span",{mi:"",btn:"",muted:""},"edit")],-1),Kt=t("p",null,[t("strong",null,"Delete"),t("br"),e(" 4. Click "),t("span",{mi:"",btn:"",dngr:""},"delete"),e(" in the header and a popup will appear."),t("br"),e(" 5. Click "),t("strong",null,"\u201CDelete\u201D"),e(" to confirm the action.")],-1),Qt=t("p",null,[t("strong",null,"Archive"),t("br"),e(" 4. Click "),t("span",{mi:"",btn:"",muted:""},"archive"),e(" in the header and a popup will appear."),t("br"),e(" 5. Click "),t("strong",null,"\u201CDelete\u201D"),e(" to confirm the action.")],-1),Xt=t("p",null,[t("strong",null,"Edit"),t("br"),e(" 4. Click "),t("span",{mi:"",btn:"",muted:""},"edit"),e(" in the header and the Item Page will open."),t("br"),e(" 5. Update Item details as desired."),t("br"),e(" 6. Click "),t("span",{mi:"",btn:""},"check"),e(" to confirm batch edits on all Items.")],-1),oe="Collection Page",se=!1,ne="The Collection Page displays all Items within a Collection and comes with highly configurable Layouts for browsing, visualizing, and managing these Items.",ie="6 min read",le={name:"collections",setup(Zt,{expose:a}){const i={title:"Collection Page",modularExtension:!1,description:"The Collection Page displays all Items within a Collection and comes with highly configurable Layouts for browsing, visualizing, and managing these Items.",readTime:"6 min read"};return a({frontmatter:i}),($t,te)=>{const s=l("router-link"),c=l("docs-wrapper");return d(),r(c,{frontmatter:i},{default:o(()=>[t("div",h,[u,t("div",m,[p,t("p",null,[_,n(s,{to:"/docs/getting-started/glossary#collections"},{default:o(()=>[g]),_:1}),y,n(s,{to:"/docs/getting-started/glossary#items"},{default:o(()=>[f]),_:1}),v,n(s,{to:"/docs/getting-started/glossary#fields"},{default:o(()=>[b]),_:1}),w])]),I,C,t("p",null,[k,n(s,{to:"/docs/app/layouts"},{default:o(()=>[A]),_:1})]),T,x,L,S,P,B,t("p",null,[F,n(s,{to:"/docs/app/filters"},{default:o(()=>[E]),_:1}),M]),N,D,t("p",null,[j,n(s,{to:"/docs/app/layouts#table-layout"},{default:o(()=>[q]),_:1}),V]),t("ol",null,[t("li",null,[z,n(s,{to:"/docs/configuration/data-model/collections#sort-field"},{default:o(()=>[U]),_:1}),O,R,H,W,Y]),G,J,K,Q]),t("div",X,[Z,t("p",null,[$,n(s,{to:"/docs/configuration/data-model/collections#sort-field"},{default:o(()=>[tt]),_:1}),et])]),t("div",ot,[t("p",null,[st,n(s,{to:"/docs/reference/query#sort"},{default:o(()=>[nt]),_:1}),it])]),lt,at,t("p",null,[ct,n(s,{to:"/docs/app/layouts"},{default:o(()=>[dt]),_:1}),rt]),ht,ut,mt,t("p",null,[pt,n(s,{to:"/docs/app/content/items#archive-an-item"},{default:o(()=>[_t]),_:1}),gt]),yt,t("div",ft,[vt,t("p",null,[bt,n(s,{to:"/docs/configuration/data-model/collections#archive"},{default:o(()=>[wt]),_:1}),It])]),Ct,kt,At,Tt,xt,t("div",Lt,[St,t("p",null,[Pt,n(s,{to:"/docs/configuration/presets-bookmarks"},{default:o(()=>[Bt]),_:1}),Ft])]),Et,Mt,t("p",null,[Nt,n(s,{to:"/docs/app/import-export"},{default:o(()=>[Dt]),_:1}),jt]),qt,Vt,zt,t("ol",null,[Ut,t("li",null,[Ot,n(s,{to:"/docs/app/layouts"},{default:o(()=>[Rt]),_:1}),Ht,Wt,Yt]),Gt]),Jt,Kt,Qt,Xt])]),_:1})}}};export{le as default,ne as description,se as modularExtension,ie as readTime,oe as title};

package/dist/assets/{collections.9e3af468.js → collections.b7aafbfb.js}

@@ -1,4 +1,4 @@
-import{a as o,o as h,b as r,w as n,g as s,e as l,B as t}from"./runtime-core.esm-bundler.e3d5f5b7.js";const d={class:"markdown-body"},p=t("Collections are the individual collections of items, similar to tables in a database. Changes to collections will alter the schema of the database. "),u=t("Learn more about Collections"),_=t("."),m=s("hr",null,null,-1),j=s("h2",{id:"the-collection-object",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#the-collection-object"},"#"),t(" The Collection Object")],-1),g=s("p",null,[s("code",null,"collection"),t(),s("strong",null,"string"),s("br"),t(" Name of the collection. This matches the table name in the database.")],-1),f=s("h4",{id:"meta",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#meta"},"#"),t(" Meta")],-1),b=s("p",null,"Directus metadata, primarily used in the Admin App.",-1),y=s("p",null,[s("code",null,"collection"),t(),s("strong",null,"string"),s("br"),t(" Name of the collection. This matches the table name in the database.")],-1),x=s("p",null,[s("code",null,"icon"),t(),s("strong",null,"string"),s("br"),t(" Icon displayed in the Admin App when working with this collection.")],-1),q=s("p",null,[s("code",null,"note"),t(),s("strong",null,"string"),s("br"),t(" Short description displayed in the Admin App.")],-1),v=s("p",null,[s("code",null,"display_template"),t(),s("strong",null,"string"),s("br"),t(" How items in this collection should be displayed when viewed relationally in the Admin App.")],-1),w=s("p",null,[s("code",null,"hidden"),t(),s("strong",null,"boolean"),s("br"),t(" Whether or not this collection is hidden in the Admin App.")],-1),T=s("p",null,[s("code",null,"singleton"),t(),s("strong",null,"boolean"),s("br"),t(" Whether or not this collection is treated as a singleton.")],-1),A=s("p",null,[s("code",null,"translations"),t(),s("strong",null,"array"),s("br"),t(" How this collection\u2019s name is displayed in the different languages in the Admin App.")],-1),k=s("p",null,[s("code",null,"archive_field"),t(),s("strong",null,"string"),s("br"),t(" What field in the collection holds the archived state.")],-1),E=s("p",null,[s("code",null,"archive_value"),t(),s("strong",null,"string"),s("br"),t(" What value the archive field should be set to when archiving an item.")],-1),S=s("p",null,[s("code",null,"unarchive_value"),t(),s("strong",null,"string"),s("br"),t(" What value the archive field should be set to when unarchiving an item.")],-1),C=s("p",null,[s("code",null,"archive_app_filter"),t(),s("strong",null,"boolean"),s("br"),t(" Whether or not the Admin App should allow the user to view archived items.")],-1),P=s("p",null,[s("code",null,"sort_field"),t(),s("strong",null,"boolean"),s("br"),t(" What field holds the sort value on the collection. The Admin App uses this to allow drag-and-drop manual sorting.")],-1),R=s("code",null,"accountability",-1),L=t(),Q=s("strong",null,"string",-1),W=s("br",null,null,-1),G=t(" What data is tracked. One of "),O=s("code",null,"all",-1),B=t(", "),D=s("code",null,"activity",-1),I=t(". See "),H=t("Accountability"),N=t(" for more information."),M=s("code",null,"item_duplication_fields",-1),U=t(),V=s("strong",null,"array",-1),Y=s("br",null,null,-1),z=t(" What fields are duplicated during \u201CSave as copy\u201D action of an item in this collection. See "),F=t("Duplication"),J=t(" for more information."),K=s("code",null,"group",-1),X=t(),Z=s("strong",null,"string",-1),$=s("br",null,null,-1),ss=t(" The name of the parent collection. This is used in "),ts=t("grouping/nesting of collections"),ns=t("."),es=s("code",null,"sort",-1),ls=t(),as=s("strong",null,"number",-1),os=s("br",null,null,-1),cs=t(" What sort order of the collection relative to other collections of the same level. This is used in "),is=t("sorting of collections"),hs=t("."),rs=s("p",null,[s("code",null,"collapse"),t(),s("strong",null,"string"),s("br"),t(" What is the default behavior of this collection or \u201Cfolder\u201D collection when it has nested collections. One of "),s("code",null,"open"),t(", "),s("code",null,"closed"),t(", "),s("code",null,"locked"),t(".")],-1),ds=s("h4",{id:"schema",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#schema"},"#"),t(" Schema")],-1),ps=s("p",null,"\u201CRaw\u201D database information. Based on the database vendor used, different information might be returned. The following are available for all drivers.",-1),us=s("p",null,[s("code",null,"name"),t(),s("strong",null,"string"),s("br"),t(" The table name.")],-1),_s=s("p",null,[s("code",null,"comment"),t(),s("strong",null,"string"),s("br"),t(" The table comment.")],-1),ms={class:"tip hint"},js=t("\u201Cfolder\u201D collections do not hold any data"),gs=t(", hence their schema would be "),fs=s("code",null,"null",-1),bs=t("."),ys=s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-punctuation"},"{"),t(`
+import{a as o,o as h,b as r,w as n,l as s,e as l,E as t}from"./runtime-core.esm-bundler.32cac88a.js";const d={class:"markdown-body"},p=t("Collections are the individual collections of items, similar to tables in a database. Changes to collections will alter the schema of the database. "),u=t("Learn more about Collections"),_=t("."),m=s("hr",null,null,-1),j=s("h2",{id:"the-collection-object",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#the-collection-object"},"#"),t(" The Collection Object")],-1),g=s("p",null,[s("code",null,"collection"),t(),s("strong",null,"string"),s("br"),t(" Name of the collection. This matches the table name in the database.")],-1),f=s("h4",{id:"meta",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#meta"},"#"),t(" Meta")],-1),b=s("p",null,"Directus metadata, primarily used in the Admin App.",-1),y=s("p",null,[s("code",null,"collection"),t(),s("strong",null,"string"),s("br"),t(" Name of the collection. This matches the table name in the database.")],-1),x=s("p",null,[s("code",null,"icon"),t(),s("strong",null,"string"),s("br"),t(" Icon displayed in the Admin App when working with this collection.")],-1),q=s("p",null,[s("code",null,"note"),t(),s("strong",null,"string"),s("br"),t(" Short description displayed in the Admin App.")],-1),v=s("p",null,[s("code",null,"display_template"),t(),s("strong",null,"string"),s("br"),t(" How items in this collection should be displayed when viewed relationally in the Admin App.")],-1),w=s("p",null,[s("code",null,"hidden"),t(),s("strong",null,"boolean"),s("br"),t(" Whether or not this collection is hidden in the Admin App.")],-1),T=s("p",null,[s("code",null,"singleton"),t(),s("strong",null,"boolean"),s("br"),t(" Whether or not this collection is treated as a singleton.")],-1),A=s("p",null,[s("code",null,"translations"),t(),s("strong",null,"array"),s("br"),t(" How this collection\u2019s name is displayed in the different languages in the Admin App.")],-1),E=s("p",null,[s("code",null,"archive_field"),t(),s("strong",null,"string"),s("br"),t(" What field in the collection holds the archived state.")],-1),k=s("p",null,[s("code",null,"archive_value"),t(),s("strong",null,"string"),s("br"),t(" What value the archive field should be set to when archiving an item.")],-1),S=s("p",null,[s("code",null,"unarchive_value"),t(),s("strong",null,"string"),s("br"),t(" What value the archive field should be set to when unarchiving an item.")],-1),C=s("p",null,[s("code",null,"archive_app_filter"),t(),s("strong",null,"boolean"),s("br"),t(" Whether or not the Admin App should allow the user to view archived items.")],-1),P=s("p",null,[s("code",null,"sort_field"),t(),s("strong",null,"boolean"),s("br"),t(" What field holds the sort value on the collection. The Admin App uses this to allow drag-and-drop manual sorting.")],-1),R=s("code",null,"accountability",-1),L=t(),Q=s("strong",null,"string",-1),W=s("br",null,null,-1),G=t(" What data is tracked. One of "),O=s("code",null,"all",-1),D=t(", "),B=s("code",null,"activity",-1),I=t(". See "),H=t("Accountability"),N=t(" for more information."),M=s("code",null,"item_duplication_fields",-1),U=t(),V=s("strong",null,"array",-1),Y=s("br",null,null,-1),z=t(" What fields are duplicated during \u201CSave as copy\u201D action of an item in this collection. See "),F=t("Duplication"),J=t(" for more information."),K=s("code",null,"group",-1),X=t(),Z=s("strong",null,"string",-1),$=s("br",null,null,-1),ss=t(" The name of the parent collection. This is used in "),ts=t("grouping/nesting of collections"),ns=t("."),es=s("code",null,"sort",-1),ls=t(),as=s("strong",null,"number",-1),os=s("br",null,null,-1),cs=t(" What sort order of the collection relative to other collections of the same level. This is used in "),is=t("sorting of collections"),hs=t("."),rs=s("p",null,[s("code",null,"collapse"),t(),s("strong",null,"string"),s("br"),t(" What is the default behavior of this collection or \u201Cfolder\u201D collection when it has nested collections. One of "),s("code",null,"open"),t(", "),s("code",null,"closed"),t(", "),s("code",null,"locked"),t(".")],-1),ds=s("h4",{id:"schema",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#schema"},"#"),t(" Schema")],-1),ps=s("p",null,"\u201CRaw\u201D database information. Based on the database vendor used, different information might be returned. The following are available for all drivers.",-1),us=s("p",null,[s("code",null,"name"),t(),s("strong",null,"string"),s("br"),t(" The table name.")],-1),_s=s("p",null,[s("code",null,"comment"),t(),s("strong",null,"string"),s("br"),t(" The table comment.")],-1),ms={class:"tip hint"},js=t("\u201Cfolder\u201D collections do not hold any data"),gs=t(", hence their schema would be "),fs=s("code",null,"null",-1),bs=t("."),ys=s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-punctuation"},"{"),t(`
 	`),s("span",{class:"hljs-attr"},'"collection"'),s("span",{class:"hljs-punctuation"},":"),t(),s("span",{class:"hljs-string"},'"articles"'),s("span",{class:"hljs-punctuation"},","),t(`
 	`),s("span",{class:"hljs-attr"},'"meta"'),s("span",{class:"hljs-punctuation"},":"),t(),s("span",{class:"hljs-punctuation"},"{"),t(`
 		`),s("span",{class:"hljs-attr"},'"collection"'),s("span",{class:"hljs-punctuation"},":"),t(),s("span",{class:"hljs-string"},'"articles"'),s("span",{class:"hljs-punctuation"},","),t(`
@@ -30,7 +30,7 @@ import{a as o,o as h,b as r,w as n,g as s,e as l,B as t}from"./runtime-core.esm-
 		`),s("span",{class:"hljs-attr"},'"comment"'),s("span",{class:"hljs-punctuation"},":"),t(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"null")]),t(`
 	`),s("span",{class:"hljs-punctuation"},"}"),t(`
 `),s("span",{class:"hljs-punctuation"},"}"),t(`
-`)])],-1),xs=s("hr",null,null,-1),qs=s("h2",{id:"list-collections",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#list-collections"},"#"),t(" List Collections")],-1),vs=s("p",null,"List the available collections.",-1),ws=s("h3",{id:"query-parameters",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters"},"#"),t(" Query Parameters")],-1),Ts=s("p",null,"This endpoint doesn\u2019t currently support any query parameters.",-1),As=s("h3",{id:"returns",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns"},"#"),t(" Returns")],-1),ks=s("p",null,[t("An array of "),s("a",{href:"#the-collection-object"},"collection objects"),t(".")],-1),Es=s("h3",{id:"rest-api",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api"},"#"),t(" REST API")],-1),Ss=s("pre",null,[s("code",null,`GET /collections
+`)])],-1),xs=s("hr",null,null,-1),qs=s("h2",{id:"list-collections",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#list-collections"},"#"),t(" List Collections")],-1),vs=s("p",null,"List the available collections.",-1),ws=s("h3",{id:"query-parameters",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters"},"#"),t(" Query Parameters")],-1),Ts=s("p",null,"This endpoint doesn\u2019t currently support any query parameters.",-1),As=s("h3",{id:"returns",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns"},"#"),t(" Returns")],-1),Es=s("p",null,[t("An array of "),s("a",{href:"#the-collection-object"},"collection objects"),t(".")],-1),ks=s("h3",{id:"rest-api",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api"},"#"),t(" REST API")],-1),Ss=s("pre",null,[s("code",null,`GET /collections
 SEARCH /collections
 `)],-1),Cs=t("Learn more about SEARCH ->"),Ps=s("h3",{id:"graphql",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql"},"#"),t(" GraphQL")],-1),Rs=s("pre",null,[s("code",null,`POST /graphql/system
 `)],-1),Ls=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),t(` {
@@ -41,7 +41,7 @@ SEARCH /collections
 		`),s("span",{class:"hljs-keyword"},"..."),t(`
 	}
 }
-`)])],-1),Gs=s("hr",null,null,-1),Os=s("h2",{id:"retrieve-a-collection",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#retrieve-a-collection"},"#"),t(" Retrieve a Collection")],-1),Bs=s("p",null,"Retrieve a single collection by table name.",-1),Ds=s("h3",{id:"query-parameters-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-1"},"#"),t(" Query Parameters")],-1),Is=s("p",null,"This endpoint doesn\u2019t currently support any query parameters.",-1),Hs=s("h3",{id:"returns-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-1"},"#"),t(" Returns")],-1),Ns=s("p",null,[t("A "),s("a",{href:"#the-collection-object"},"collection object"),t(".")],-1),Ms=s("h3",{id:"rest-api-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-1"},"#"),t(" REST API")],-1),Us=s("pre",null,[s("code",null,`GET /collections/:collection
+`)])],-1),Gs=s("hr",null,null,-1),Os=s("h2",{id:"retrieve-a-collection",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#retrieve-a-collection"},"#"),t(" Retrieve a Collection")],-1),Ds=s("p",null,"Retrieve a single collection by table name.",-1),Bs=s("h3",{id:"query-parameters-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-1"},"#"),t(" Query Parameters")],-1),Is=s("p",null,"This endpoint doesn\u2019t currently support any query parameters.",-1),Hs=s("h3",{id:"returns-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-1"},"#"),t(" Returns")],-1),Ns=s("p",null,[t("A "),s("a",{href:"#the-collection-object"},"collection object"),t(".")],-1),Ms=s("h3",{id:"rest-api-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-1"},"#"),t(" REST API")],-1),Us=s("pre",null,[s("code",null,`GET /collections/:collection
 `)],-1),Vs=s("h5",{id:"example-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-1"},"#"),t(" Example")],-1),Ys=s("pre",null,[s("code",null,`GET /collections/articles
 `)],-1),zs=s("h3",{id:"graphql-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-1"},"#"),t(" GraphQL")],-1),Fs=s("pre",null,[s("code",null,`POST /graphql/system
 `)],-1),Js=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),t(` {
@@ -65,7 +65,7 @@ SEARCH /collections
 `)],-1),At=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),t(` {
 	create_collections_item(data: directus_collections): directus_collections
 }
-`)])],-1),kt=s("h5",{id:"example-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-4"},"#"),t(" Example")],-1),Et=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),t(` {
+`)])],-1),Et=s("h5",{id:"example-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-4"},"#"),t(" Example")],-1),kt=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),t(` {
 	create_collections_item(data: {
 		collection: `),s("span",{class:"hljs-string"},'"testimonials"'),t(`,
 		meta: {
@@ -75,7 +75,7 @@ SEARCH /collections
 		`),s("span",{class:"hljs-keyword"},"..."),t(`
 	}
 }
-`)])],-1),St=s("hr",null,null,-1),Ct=s("h2",{id:"update-a-collection",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#update-a-collection"},"#"),t(" Update a Collection")],-1),Pt=s("p",null,"Update the metadata for an existing collection.",-1),Rt=s("h3",{id:"query-parameters-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-3"},"#"),t(" Query Parameters")],-1),Lt=s("p",null,"This endpoint doesn\u2019t currently support any query parameters.",-1),Qt=s("h3",{id:"request-body-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-1"},"#"),t(" Request Body")],-1),Wt=s("p",null,[t("You can only update the "),s("code",null,"meta"),t(" values of the "),s("a",{href:"#the-collection-object"},"collection object"),t(". Updating the collection name is not supported at this time.")],-1),Gt=s("h3",{id:"returns-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-3"},"#"),t(" Returns")],-1),Ot=s("p",null,[t("The "),s("a",{href:"#the-collection-object"},"collection object"),t(" for the updated collection in this request.")],-1),Bt=s("h3",{id:"rest-api-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-3"},"#"),t(" REST API")],-1),Dt=s("pre",null,[s("code",null,`PATCH /collections/:collection
+`)])],-1),St=s("hr",null,null,-1),Ct=s("h2",{id:"update-a-collection",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#update-a-collection"},"#"),t(" Update a Collection")],-1),Pt=s("p",null,"Update the metadata for an existing collection.",-1),Rt=s("h3",{id:"query-parameters-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-3"},"#"),t(" Query Parameters")],-1),Lt=s("p",null,"This endpoint doesn\u2019t currently support any query parameters.",-1),Qt=s("h3",{id:"request-body-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-1"},"#"),t(" Request Body")],-1),Wt=s("p",null,[t("You can only update the "),s("code",null,"meta"),t(" values of the "),s("a",{href:"#the-collection-object"},"collection object"),t(". Updating the collection name is not supported at this time.")],-1),Gt=s("h3",{id:"returns-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-3"},"#"),t(" Returns")],-1),Ot=s("p",null,[t("The "),s("a",{href:"#the-collection-object"},"collection object"),t(" for the updated collection in this request.")],-1),Dt=s("h3",{id:"rest-api-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-3"},"#"),t(" REST API")],-1),Bt=s("pre",null,[s("code",null,`PATCH /collections/:collection
 `)],-1),It=s("h5",{id:"example-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-5"},"#"),t(" Example")],-1),Ht=s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// PATCH /collections/testimonials"),t(`
 
 `),s("span",{class:"hljs-punctuation"},"{"),t(`
@@ -103,4 +103,4 @@ SEARCH /collections
 		collection
 	}
 }
-`)])],-1),on=s("hr",null,null,-1),pn="Collections",un=!1,_n='REST and GraphQL API documentation on the "Collections" collection in Directus.',mn="5 min read",jn="page-reference",gn={name:"collections",setup(cn,{expose:c}){const a={title:"Collections",modularExtension:!1,description:'REST and GraphQL API documentation on the "Collections" collection in Directus.',readTime:"5 min read",pageClass:"page-reference"};return c({frontmatter:a}),(hn,rn)=>{const e=o("router-link"),i=o("docs-wrapper");return h(),r(i,{frontmatter:a},{default:n(()=>[s("div",d,[s("blockquote",null,[s("p",null,[p,l(e,{to:"/docs/getting-started/glossary#collections"},{default:n(()=>[u]),_:1}),_])]),m,j,g,f,b,y,x,q,v,w,T,A,k,E,S,C,P,s("p",null,[R,L,Q,W,G,O,B,D,I,l(e,{to:"/docs/configuration/data-model#accountability"},{default:n(()=>[H]),_:1}),N]),s("p",null,[M,U,V,Y,z,l(e,{to:"/docs/configuration/data-model#duplication"},{default:n(()=>[F]),_:1}),J]),s("p",null,[K,X,Z,$,ss,l(e,{to:"/docs/configuration/data-model#sorting-grouping"},{default:n(()=>[ts]),_:1}),ns]),s("p",null,[es,ls,as,os,cs,l(e,{to:"/docs/configuration/data-model#sorting-grouping"},{default:n(()=>[is]),_:1}),hs]),rs,ds,ps,us,_s,s("div",ms,[s("p",null,[l(e,{to:"/docs/configuration/data-model#sorting-grouping"},{default:n(()=>[js]),_:1}),gs,fs,bs])]),ys,xs,qs,vs,ws,Ts,As,ks,Es,Ss,s("p",null,[l(e,{to:"/docs/reference/introduction#search-http-method"},{default:n(()=>[Cs]),_:1})]),Ps,Rs,Ls,Qs,Ws,Gs,Os,Bs,Ds,Is,Hs,Ns,Ms,Us,Vs,Ys,zs,Fs,Js,Ks,Xs,Zs,$s,st,tt,nt,et,lt,s("p",null,[at,ot,ct,l(e,{to:"/docs/reference/system/fields#the-fields-object"},{default:n(()=>[it]),_:1}),ht]),rt,dt,s("div",pt,[s("p",null,[ut,_t,mt,jt,gt,l(e,{to:"/docs/configuration/data-model#sorting-grouping"},{default:n(()=>[ft]),_:1}),bt])]),yt,xt,qt,vt,wt,Tt,At,kt,Et,St,Ct,Pt,Rt,Lt,Qt,Wt,Gt,Ot,Bt,Dt,It,Ht,Nt,Mt,Ut,Vt,Yt,zt,Ft,Jt,Kt,Xt,Zt,$t,sn,tn,nn,en,ln,an,on])]),_:1})}}};export{gn as default,_n as description,un as modularExtension,jn as pageClass,mn as readTime,pn as title};
+`)])],-1),on=s("hr",null,null,-1),pn="Collections",un=!1,_n='REST and GraphQL API documentation on the "Collections" collection in Directus.',mn="5 min read",jn="page-reference",gn={name:"collections",setup(cn,{expose:c}){const a={title:"Collections",modularExtension:!1,description:'REST and GraphQL API documentation on the "Collections" collection in Directus.',readTime:"5 min read",pageClass:"page-reference"};return c({frontmatter:a}),(hn,rn)=>{const e=o("router-link"),i=o("docs-wrapper");return h(),r(i,{frontmatter:a},{default:n(()=>[s("div",d,[s("blockquote",null,[s("p",null,[p,l(e,{to:"/docs/getting-started/glossary#collections"},{default:n(()=>[u]),_:1}),_])]),m,j,g,f,b,y,x,q,v,w,T,A,E,k,S,C,P,s("p",null,[R,L,Q,W,G,O,D,B,I,l(e,{to:"/docs/configuration/data-model#accountability"},{default:n(()=>[H]),_:1}),N]),s("p",null,[M,U,V,Y,z,l(e,{to:"/docs/configuration/data-model#duplication"},{default:n(()=>[F]),_:1}),J]),s("p",null,[K,X,Z,$,ss,l(e,{to:"/docs/configuration/data-model#sorting-grouping"},{default:n(()=>[ts]),_:1}),ns]),s("p",null,[es,ls,as,os,cs,l(e,{to:"/docs/configuration/data-model#sorting-grouping"},{default:n(()=>[is]),_:1}),hs]),rs,ds,ps,us,_s,s("div",ms,[s("p",null,[l(e,{to:"/docs/configuration/data-model#sorting-grouping"},{default:n(()=>[js]),_:1}),gs,fs,bs])]),ys,xs,qs,vs,ws,Ts,As,Es,ks,Ss,s("p",null,[l(e,{to:"/docs/reference/introduction#search-http-method"},{default:n(()=>[Cs]),_:1})]),Ps,Rs,Ls,Qs,Ws,Gs,Os,Ds,Bs,Is,Hs,Ns,Ms,Us,Vs,Ys,zs,Fs,Js,Ks,Xs,Zs,$s,st,tt,nt,et,lt,s("p",null,[at,ot,ct,l(e,{to:"/docs/reference/system/fields#the-fields-object"},{default:n(()=>[it]),_:1}),ht]),rt,dt,s("div",pt,[s("p",null,[ut,_t,mt,jt,gt,l(e,{to:"/docs/configuration/data-model#sorting-grouping"},{default:n(()=>[ft]),_:1}),bt])]),yt,xt,qt,vt,wt,Tt,At,Et,kt,St,Ct,Pt,Rt,Lt,Qt,Wt,Gt,Ot,Dt,Bt,It,Ht,Nt,Mt,Ut,Vt,Yt,zt,Ft,Jt,Kt,Xt,Zt,$t,sn,tn,nn,en,ln,an,on])]),_:1})}}};export{gn as default,_n as description,un as modularExtension,jn as pageClass,mn as readTime,pn as title};

package/dist/assets/{commonlisp.3ab42a16.js → commonlisp.78d28584.js}

@@ -1 +1 @@
-import{y}from"./index.5552d1ba.entry.js";function k(c,d){return d.forEach(function(i){i&&typeof i!="string"&&!Array.isArray(i)&&Object.keys(i).forEach(function(l){if(l!=="default"&&!(l in c)){var u=Object.getOwnPropertyDescriptor(i,l);Object.defineProperty(c,l,u.get?u:{enumerable:!0,get:function(){return i[l]}})}})}),Object.freeze(Object.defineProperty(c,Symbol.toStringTag,{value:"Module"}))}var x={exports:{}};(function(c,d){(function(i){i(y.exports)})(function(i){i.defineMode("commonlisp",function(l){var u=/^(block|let*|return-from|catch|load-time-value|setq|eval-when|locally|symbol-macrolet|flet|macrolet|tagbody|function|multiple-value-call|the|go|multiple-value-prog1|throw|if|progn|unwind-protect|labels|progv|let|quote)$/,s=/^with|^def|^do|^prog|case$|^cond$|bind$|when$|unless$/,a=/^(?:[+\-]?(?:\d+|\d*\.\d+)(?:[efd][+\-]?\d+)?|[+\-]?\d+(?:\/[+\-]?\d+)?|#b[+\-]?[01]+|#o[+\-]?[0-7]+|#x[+\-]?[\da-f]+)/,b=/[^\s'`,@()\[\]";]/,o;function f(e){for(var n;n=e.next();)if(n=="\\")e.next();else if(!b.test(n)){e.backUp(1);break}return e.current()}function p(e,n){if(e.eatSpace())return o="ws",null;if(e.match(a))return"number";var t=e.next();if(t=="\\"&&(t=e.next()),t=='"')return(n.tokenize=m)(e,n);if(t=="(")return o="open","bracket";if(t==")"||t=="]")return o="close","bracket";if(t==";")return e.skipToEnd(),o="ws","comment";if(/['`,@]/.test(t))return null;if(t=="|")return e.skipTo("|")?(e.next(),"symbol"):(e.skipToEnd(),"error");if(t=="#"){var t=e.next();return t=="("?(o="open","bracket"):/[+\-=\.']/.test(t)||/\d/.test(t)&&e.match(/^\d*#/)?null:t=="|"?(n.tokenize=v)(e,n):t==":"?(f(e),"meta"):t=="\\"?(e.next(),f(e),"string-2"):"error"}else{var r=f(e);return r=="."?null:(o="symbol",r=="nil"||r=="t"||r.charAt(0)==":"?"atom":n.lastType=="open"&&(u.test(r)||s.test(r))?"keyword":r.charAt(0)=="&"?"variable-2":"variable")}}function m(e,n){for(var t=!1,r;r=e.next();){if(r=='"'&&!t){n.tokenize=p;break}t=!t&&r=="\\"}return"string"}function v(e,n){for(var t,r;t=e.next();){if(t=="#"&&r=="|"){n.tokenize=p;break}r=t}return o="ws","comment"}return{startState:function(){return{ctx:{prev:null,start:0,indentTo:0},lastType:null,tokenize:p}},token:function(e,n){e.sol()&&typeof n.ctx.indentTo!="number"&&(n.ctx.indentTo=n.ctx.start+1),o=null;var t=n.tokenize(e,n);return o!="ws"&&(n.ctx.indentTo==null?o=="symbol"&&s.test(e.current())?n.ctx.indentTo=n.ctx.start+l.indentUnit:n.ctx.indentTo="next":n.ctx.indentTo=="next"&&(n.ctx.indentTo=e.column()),n.lastType=o),o=="open"?n.ctx={prev:n.ctx,start:e.column(),indentTo:null}:o=="close"&&(n.ctx=n.ctx.prev||n.ctx),t},indent:function(e,n){var t=e.ctx.indentTo;return typeof t=="number"?t:e.ctx.start+1},closeBrackets:{pairs:'()[]{}""'},lineComment:";;",blockCommentStart:"#|",blockCommentEnd:"|#"}}),i.defineMIME("text/x-common-lisp","commonlisp")})})();var h=x.exports,g=k({__proto__:null,default:h},[x.exports]);export{g as c};
+import{y}from"./index.c02613ac.entry.js";function k(c,d){return d.forEach(function(i){i&&typeof i!="string"&&!Array.isArray(i)&&Object.keys(i).forEach(function(l){if(l!=="default"&&!(l in c)){var u=Object.getOwnPropertyDescriptor(i,l);Object.defineProperty(c,l,u.get?u:{enumerable:!0,get:function(){return i[l]}})}})}),Object.freeze(Object.defineProperty(c,Symbol.toStringTag,{value:"Module"}))}var x={exports:{}};(function(c,d){(function(i){i(y.exports)})(function(i){i.defineMode("commonlisp",function(l){var u=/^(block|let*|return-from|catch|load-time-value|setq|eval-when|locally|symbol-macrolet|flet|macrolet|tagbody|function|multiple-value-call|the|go|multiple-value-prog1|throw|if|progn|unwind-protect|labels|progv|let|quote)$/,s=/^with|^def|^do|^prog|case$|^cond$|bind$|when$|unless$/,a=/^(?:[+\-]?(?:\d+|\d*\.\d+)(?:[efd][+\-]?\d+)?|[+\-]?\d+(?:\/[+\-]?\d+)?|#b[+\-]?[01]+|#o[+\-]?[0-7]+|#x[+\-]?[\da-f]+)/,b=/[^\s'`,@()\[\]";]/,o;function f(e){for(var n;n=e.next();)if(n=="\\")e.next();else if(!b.test(n)){e.backUp(1);break}return e.current()}function p(e,n){if(e.eatSpace())return o="ws",null;if(e.match(a))return"number";var t=e.next();if(t=="\\"&&(t=e.next()),t=='"')return(n.tokenize=m)(e,n);if(t=="(")return o="open","bracket";if(t==")"||t=="]")return o="close","bracket";if(t==";")return e.skipToEnd(),o="ws","comment";if(/['`,@]/.test(t))return null;if(t=="|")return e.skipTo("|")?(e.next(),"symbol"):(e.skipToEnd(),"error");if(t=="#"){var t=e.next();return t=="("?(o="open","bracket"):/[+\-=\.']/.test(t)||/\d/.test(t)&&e.match(/^\d*#/)?null:t=="|"?(n.tokenize=v)(e,n):t==":"?(f(e),"meta"):t=="\\"?(e.next(),f(e),"string-2"):"error"}else{var r=f(e);return r=="."?null:(o="symbol",r=="nil"||r=="t"||r.charAt(0)==":"?"atom":n.lastType=="open"&&(u.test(r)||s.test(r))?"keyword":r.charAt(0)=="&"?"variable-2":"variable")}}function m(e,n){for(var t=!1,r;r=e.next();){if(r=='"'&&!t){n.tokenize=p;break}t=!t&&r=="\\"}return"string"}function v(e,n){for(var t,r;t=e.next();){if(t=="#"&&r=="|"){n.tokenize=p;break}r=t}return o="ws","comment"}return{startState:function(){return{ctx:{prev:null,start:0,indentTo:0},lastType:null,tokenize:p}},token:function(e,n){e.sol()&&typeof n.ctx.indentTo!="number"&&(n.ctx.indentTo=n.ctx.start+1),o=null;var t=n.tokenize(e,n);return o!="ws"&&(n.ctx.indentTo==null?o=="symbol"&&s.test(e.current())?n.ctx.indentTo=n.ctx.start+l.indentUnit:n.ctx.indentTo="next":n.ctx.indentTo=="next"&&(n.ctx.indentTo=e.column()),n.lastType=o),o=="open"?n.ctx={prev:n.ctx,start:e.column(),indentTo:null}:o=="close"&&(n.ctx=n.ctx.prev||n.ctx),t},indent:function(e,n){var t=e.ctx.indentTo;return typeof t=="number"?t:e.ctx.start+1},closeBrackets:{pairs:'()[]{}""'},lineComment:";;",blockCommentStart:"#|",blockCommentEnd:"|#"}}),i.defineMIME("text/x-common-lisp","commonlisp")})})();var h=x.exports,g=k({__proto__:null,default:h},[x.exports]);export{g as c};

package/dist/assets/{conditions.1d6c9ac3.js → conditions.281a6ed5.js}

@@ -1 +1 @@
-import{a as n,o as r,b as a,w as s,g as e,e as d,B as t}from"./runtime-core.esm-bundler.e3d5f5b7.js";const c={class:"markdown-body"},u=e("p",null,"Conditions allow you to alter the current field\u2019s setup based on the values of other fields in the form. This allows you to show/hide the field, make it readonly, or change the interface options.",-1),_=e("p",null,[t("Each field can have one or more "),e("em",null,"rules"),t(". Each rule has the following configuration options:")],-1),f=e("li",null,[e("strong",null,"Name"),t(": The name of the rule. This is only used internally for convenience purposes")],-1),p=e("strong",null,"Rule",-1),m=t(": The rule that controls whether or not these conditions are applied. Rule follows the "),g=t("Filter Rules"),w=t(" spec"),y=e("li",null,[e("strong",null,"Readonly"),t(": Whether or not the field is readonly when the condition is matched")],-1),T=e("li",null,[e("strong",null,"Hidden"),t(": Whether or not the field is hidden when the condition is matched")],-1),v=e("li",null,[e("strong",null,"Required"),t(": Whether or not the field is required when the condition is matched")],-1),k=e("li",null,[e("strong",null,"Interface Options"),t(": Any additional configuration for the selected interface")],-1),x=e("p",null,"These changes to the field are merged onto the base configuration of the field. This means you can have the field hidden by default, and then only toggle the hidden state of the field in the condition.",-1),b=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Order Matters"),e("p",null,[t("The conditions are matched in order. The "),e("strong",null,"last"),t(" condition that matches is the one that\u2019s used to apply the changes.")])],-1),N="Conditions",V=!1,W={name:"conditions",setup(C,{expose:i}){const o={title:"Conditions",modularExtension:!1};return i({frontmatter:o}),(R,B)=>{const l=n("router-link"),h=n("docs-wrapper");return r(),a(h,{frontmatter:o},{default:s(()=>[e("div",c,[u,_,e("ul",null,[f,e("li",null,[p,m,d(l,{to:"/docs/reference/filter-rules"},{default:s(()=>[g]),_:1}),w]),y,T,v,k]),x,b])]),_:1})}}};export{W as default,V as modularExtension,N as title};
+import{a as n,o as r,b as a,w as s,l as e,e as d,E as t}from"./runtime-core.esm-bundler.32cac88a.js";const c={class:"markdown-body"},u=e("p",null,"Conditions allow you to alter the current field\u2019s setup based on the values of other fields in the form. This allows you to show/hide the field, make it readonly, or change the interface options.",-1),_=e("p",null,[t("Each field can have one or more "),e("em",null,"rules"),t(". Each rule has the following configuration options:")],-1),f=e("li",null,[e("strong",null,"Name"),t(": The name of the rule. This is only used internally for convenience purposes")],-1),p=e("strong",null,"Rule",-1),m=t(": The rule that controls whether or not these conditions are applied. Rule follows the "),g=t("Filter Rules"),w=t(" spec"),y=e("li",null,[e("strong",null,"Readonly"),t(": Whether or not the field is readonly when the condition is matched")],-1),T=e("li",null,[e("strong",null,"Hidden"),t(": Whether or not the field is hidden when the condition is matched")],-1),v=e("li",null,[e("strong",null,"Required"),t(": Whether or not the field is required when the condition is matched")],-1),k=e("li",null,[e("strong",null,"Interface Options"),t(": Any additional configuration for the selected interface")],-1),x=e("p",null,"These changes to the field are merged onto the base configuration of the field. This means you can have the field hidden by default, and then only toggle the hidden state of the field in the condition.",-1),b=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Order Matters"),e("p",null,[t("The conditions are matched in order. The "),e("strong",null,"last"),t(" condition that matches is the one that\u2019s used to apply the changes.")])],-1),B="Conditions",V=!1,W={name:"conditions",setup(C,{expose:i}){const o={title:"Conditions",modularExtension:!1};return i({frontmatter:o}),(E,R)=>{const l=n("router-link"),h=n("docs-wrapper");return r(),a(h,{frontmatter:o},{default:s(()=>[e("div",c,[u,_,e("ul",null,[f,e("li",null,[p,m,d(l,{to:"/docs/reference/filter-rules"},{default:s(()=>[g]),_:1}),w]),y,T,v,k]),x,b])]),_:1})}}};export{W as default,V as modularExtension,B as title};