CMS: Supported Content in Collection Field Types
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 default format determined by your site's Language & Region settings. 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 AM/PM
Examples: 12:45 AM, 11:15 PM |
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?
Yes. You can store up to 500KB of data in a single item's total collection fields. This limit does not apply to image, document, multi document, video, audio, or media gallery fields. Click here to vote for increasing the storage limits.
Can I create a dynamic link that visitors click to send emails?
Yes. You can create dynamic links that open the visitor's mail client (e.g., Outlook, Gmail) so they can send an email to the relevant address.
Option 1: Use the Email field type (Recommended)
The easiest method is to use the Email field type, which automatically validates email addresses and creates the link for you.
Add an 'Email' field to your collection.
Enter the email addresses (e.g., support@email.com).
Connect a button or image to the dataset.
Set the Click action connects to drop-down to your 'Email' field.
Option 2: Use a URL field (Alternative)
You can also use a standard URL field if you prefer to manually format the link.
Create a URL field type in your collection.
Add the email addresses with mailto: at the beginning of each address (e.g., mailto:support@email.com).
Link a button or image to a dataset and connect it to this 'URL' field.
How do I connect page elements to collections?
Connect page elements to datasets which connect to the relevant collections. Once connected, you decide which collection fields connect to each part of the page elements.
For example, with image elements, you can connect the:
Image source to an image field type in your collection.
Alt text source to a text field type in your collection.
Link (when clicked) to a URL field type, a dynamic item page, or various click actions such as Submit, Load more, or Next item.
Learn more about connecting page elements to datasets.
Can I add a tooltip to an image that appears when visitors hover over the image?
We have removed the option to add tooltips to image elements as tooltips are not accessible to all users. It is no longer possible to set tooltips for static images or images that connect to the CMS. Instead, use the alt text field to explain images in a way that screen readers can understand them.
Learn more about CMS alt text best practices.
Can I add default values to fields?
Yes. You can add default field values that populate automatically whenever you add new items to your collection.
Important: Default field values are not applied to items added via input elements or the Wix app. These default fields only apply to items that you or site collaborators add within your CMS collections from desktop computers.
Can I change the field type directly in a collection?
Yes, you can change the field type for most fields in your collection. However, be aware that changing a field type may disconnect connections to page elements on your live site.
Note: You cannot change the field type for 'Primary' fields, 'System' fields, or fields in collections added to Wix Multilingual. Learn how to change a field type.
Need A Professional Website?
Contact Us Today!
I'm a paragraph. I'm connected
I'm a paragraph. I'm connected
I'm a paragraph. I'm connected
I'm a paragraph. I'm connected
I'm a paragraph. I'm connected
I'm a paragraph. I'm connected