CMS: Supported Content in Collection Field Types
7 min
In this article
- Content limitations for each collection field type
- Essentials
- Organization & Reference
- Media
- Time and location
- Javascript (Velo code)
- FAQs
In your CMS (Content Management System) collections, the field type determines what kind of content you can store in the field. For example, you cannot store alphabetic letters in the 'Number' field type reserved for numbers only. The field type also determines which site elements can connect to the field.
Note:
When you upload files to your collection—such as images, videos, or documents—they are stored in the Wix Media Manager. The CMS stores the link (URL) to these files. Therefore, the supported file types and size limits for your collection fields match the limits of the Wix Media Manager.
Content limitations for each collection field type
CMS field types are grouped into five categories in the field picker: Essentials, Organization & Reference, Media, Time and location, and Javascript (Velo code). View each field type's content limitations by category below.
Essentials
| Field type | Supported content and limits |
|---|---|
| Text | Store plain text for use with titles, paragraphs, descriptions, and other text-based content. |
| Rich text | Create and manage text using formatting options, directly in your CMS. |
| Rich content | Create and manage content with rich text formatting, media embeds, and other advanced features directly in your CMS. Learn more about working with rich content and connecting it to dynamic pages. |
| URL | Store web addresses to use as links. You can use the following formats only: http://, https://, ftp://, mailto:, sms:, tel: Web addresses must be in the format http:// or https://. Entries that start with www. are automatically converted to http://. |
| Store email addresses. The CMS automatically validates that the content is in a valid email format (e.g., mail@example.com). Connect this field to buttons or images to create dynamic links that open the visitor's email client. | |
| Number | Store numerical data for various purposes such as ID, rating, order number, quantity, price, or dimensions. You can save any value from -2147483647 to 2147483647. |
| Boolean | Store binary "yes/no" or "true/false" values that appear as checkboxes in the collection fields. You can only use the Boolean field type with the checkbox user input. |
| Color | Store HEX numbers that represent colors in each field. |
Organization & Reference
| Field type | Supported content and limits |
|---|---|
| Reference | Create a relationship between content items by referencing another content item. This field can only be used to reference an item stored in another collection. |
| Multi-reference | Create many relationships between content items by referencing multiple other content items. Those references can also be linked to multiple sources. |
| Tags | Manage and categorize content items using keywords or descriptive labels. You can use this field to apply tags to an item or allow visitors to submit selections from a multi checkbox element. |
| Category | Assign items in your collection to categories stored in a category collection. Categories help organize and filter content, and can power category pages on your site. |
Media
Field type | Supported content and limits |
|---|---|
Image | Store image files supported by the Media Manager (e.g. JPG, PNG, SVG, GIF). View supported files and size limits. Tip: You can add images to the fields by pasting their image URLs in the fields. |
Media gallery | Store multiple images or videos supported by the Media Manager for each item. View supported files and size limits. |
Video | Store single video files supported by the Media Manager (e.g. AVI, MPEG, MP4, MOV). View supported files and size limits. |
Audio | Store single audio files supported by the Media Manager (e.g. AAC, AIF, FLAC, MP3, WAV). View supported files and size limits. |
Document | Store single document or archive files (e.g. PDF, DOC, ZIP) supported by the Media Manager. You cannot upload password protected documents. View supported files and size limits. Tip: You can add documents by pasting their URLs in the collection fields. |
Multiple documents | Store multiple document or archive files (e.g. PDF, ZIP) for each collection item. Connect the upload button input element to the 'Multiple documents' field type to let visitors upload several files at once to your collection. View supported files and size limits. Tip: You can add multiple documents by pasting their URLs in the collection fields. |
Digital asset | Store one secured file per collection item. Only functions in catalog collections, where it can be mapped as the digital file customers receive after purchase. A catalog collection can include more than one Digital asset field, but only one can be mapped as the digital file for sale at a time. The Digital asset field does not connect directly to page elements, does not support default values, and cannot be converted to another field type. Supported files and size limits follow Wix Media Manager rules. Learn more about the Digital asset field type. |
Time and location
Field type | Supported content and limits |
|---|---|
Date | Use date values to display them on your site, save user inputs, or both. Add the date picker user input element if you want site visitors to submit dates to your collection. In your collection, the date field displays in the following format: Month, Day, Year (e.g. Feb 14, 2024). When you connect the date field to an element on your site, you can choose to display the date in another format, for example Short, Medium, Long, or Full date. To import date content into a collection, the value in the source file must precisely match one of the following formats:
Please note the different separators used in each option. Note: The Include time field checkbox has been replaced by the 'Date and Time' field type. If you previously enabled Include time field for a 'Date' field, it was automatically converted to 'Date and Time'. No action is needed, and your existing data was kept. |
Date and Time | Use date and exact time values to display them on your site, save user inputs, or both. Add the date picker user input element if you want site visitors to submit dates to your collection. In your collection, the field displays the date followed by the time. When you connect the date field to an element on your site, you can choose to display the date in another format, for example Short, Medium, Long, or Full date. |
Time | Store time information for associated items independently of the date. The time is stored in the following format: HH:mm:ss HH: Hours in 24-hour format (16:00, not 4:00) mm: Minutes Examples: 16:45, 16:45 |
Address | Store structured data for physical addresses such as street names, city, state/province, postal code, and country. |
Javascript (Velo code)
Field type | Supported content and limits |
|---|---|
Object | Manage complex and structured data using custom objects or data structures. You can use the 'Object' field type to store and organize multiple related pieces of data as a single unit. This allows you to turn a string into an "object" data type in JavaScript while working with a collection via API. Note: Object keys that start with "$" are not supported by the 'Object' field type. |
Array | Input and manage multiple values within a single field. You can use the 'Array' field type to handle a collection of related data, such as a list of options, tags, or other sets of related values. Allows turning a string into an "array" data type in JavaScript while working with a collection via API. Note: The value in Object and Array fields has to be a valid JSON, entering anything else results in saving a string. JavaScript does not require putting field names in quotes, JSON does. For example: [{ "rating": "rating 1", "value": 1 }, { "rating": "rating 2", "value": 2 }] |
FAQs
Click below for answers to common questions about the supported content in each field type.
Are there storage limits for collection fields?
Can I create a dynamic link that visitors click to send emails?
How do I connect page elements to collections?
Can I add a tooltip to an image that appears when visitors hover over the image?
Can I add default values to fields?
Can I change the field type directly in a collection?
