Wix Content Collection Fields: Helpful Tips on How to Use Them Properly

Your content collections store your site's content. The collections organize your content with items (rows) and fields (columns). The fields usually describe the items. For example, if one item is a car, a field may list its color. The image below shows a collection of 4 fields and 5 items. Regular Fields Each field in a collection has a , (Velo by Wix only), and . Field Name Field Key Field Type Field Name The is the label you see at the top of the column in the Content Manager. The is also used in the connect panel for elements you can connect to a dataset connector in the Editor. Field Name Field Name For example, when connecting a text element to a field from your collection, you use the in the Connect Text panel. Field Name When you add a new field in the Content Manager, you specify the . You can change the after the field has been created, and all connections to that field will be updated. Field Name Field Name (Velo by Wix users only) Field Key The is used when referring to the field in code using the or . Field Key Data API Dataset API For example, if you want to insert an item using the Data API, you use the . Field Key wixData.insert( , { : }); "CollectionName" "fieldKey" "value" When you add a new field in the Content Manager, the is created automatically based on the . You can specify your own field key, if you wish. Field Key Field Name Note: You cannot change the once the field has been created. Field Key Field Type The defines what kind of content the field contains. When you add a new field in the Content Manager, you choose one of the following . You can read about field type support and limitations . Field Type Field Types here Reference Text Image Boolean Number Date and Time Address Rich Text URL File Video Media Gallery Time Tags The field type is used when connecting page elements to fields in your collections. You can only connect certain to fields of relevant . For example, you can connect a text element to a Text or URL field but not to an Image field. input elements Field Types While the Content Manager doesn't allow you to add new values of the wrong field type, content imported from a CSV file or added via code is not validated. For example, you could import a text value to a number field. In this case, the Content Manager will show an error. You use the Reference field type to select items from the Main field of the referenced collection. For more information, see . Adding a Reference Field to a Database Collection Note: You can . Make sure to consider the effect this can have on your site before you do so. change a field's type Main Fields Every content collection has a Main field which are used by reference fields to create connections between collections. A collection's Main field is indicated by a lock icon next to its field name. By default, the field is the Main field. You can define any text field in your collection to be the Main field except for the ID system field. Title When you fill in information in a Reference field, you select from the values in the Main field of the referenced collection. If you change the Main field in the referenced collection, the values displayed in the reference field change to match the ones in the new Main field. It is good practice to ensure that each item has a unique value in the Main field. For more information, see . About Reference Fields System Fields Every content collection contains the default fields shown here. They cannot be edited and are hidden by default. https://support.wix.com/en/article/about-collection-permissions Calculated Fields When you create a , a new field is added to the collection that the dynamic page pulls content from. This field contains a calculated URL with the dynamic page's prefix and the values of the fields that determine which content will be bound to the page. dynamic page For example, you might have a dynamic item page to show items from a collection based on their field. In your collection there will be a field called with URLs such as and . Dishes Title Dishes (Title) /Dishes/pizza /Dishes/chicken When a visitor goes to a dynamic page, all the items in the collection with a URL that matches the URL of the page will be bound to the page's dataset. For dynamic item pages, each item will have a unique URL. For dynamic category pages, multiple items will share a URL. You cannot edit the contents of calculated fields. However, if you change the URL of your dynamic page, the URL in your collection will change accordingly. If you create multiple dynamic pages based on a collection, the collection will have one calculated field for each dynamic page. For more information, see . About Calculated Fields Before you create a collection you may want to read about . Planning Your Database Model You can also learn more . Accessing Your Sandbox and Live Content Collections Previously published at https://support.wix.com/en/article/about-your-content-collection-fields