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.

Content limitations for each collection field type

View each field type's content limitations in the table below:

Field Type

Content Limitations

Text

Store plain text for use with titles, descriptions, and other text-based content.

Image

Store the following types of image files: JPG, PNG, SVG, and GIF

You can add images to fields by pasting their image URLs in the fields.

Max size: 25 MB

Boolean

Store binary "true" or "false" values that appear as checkboxes in the collection fields.

You can only use the boolean field type with the Checkbox user input.

Number

Store numerical data for various purposes (e.g. quantity, price, dimensions). You can save any value from -2147483647 to 2147483647.

Date

Use date and optional 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 date field displays in the following format: Month, Day, Year (e.g. Feb 14, 2024)

The optional time value displays after the date in a 12-hour format: HH:MM:AM/PM (e.g. 11:30:PM)

When you connect the date field to an element on your site, you can choose to display the date and time in another format (e.g. Short, Medium, Long, or Full date).

To import date and time content into a collection, the value in the source file must precisely match one of the following formats:

• MM/DD/YYYY HH:mm (Recommended)

• YYYY-MM-DDTHH:mm

• DD/MM/YYYY HH:mm

Please note the different separators used in each option.

Velo: When creating a date field in your collection, if you include the time field, the data is treated as a date field (object). However, if you do not include the time field, the data is treated as a type of string.

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

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.

Rich Text

Create and manage text using formatting options, directly in your CMS.

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.

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://.

Document

Store single document files for each item. You can add documents to fields by pasting their document URLs in the fields.

You can save the following document file types: DOC, DOCX, XLS, XLSX, PPT, PPTX, ODT, ODP, and PDF

You cannot upload password protected documents.

Max size: 25 MB

Multi Document

Store multiple document files for each item. You can also add multiple documents to fields by pasting their URLs in the fields.

Connect the upload button input element to the multi document field type to let visitors upload several files at once to your collection.

Video

Store single video files for each item. You can save the following video file types: AVI, MPEG, MPE, MP4, MKV, WEBM, MOV, OGV, VOB, M4V, 3GP, DIVX, and XVID

Max size: 1GB

Audio

Store single audio files for each item. You can store the following file types only: AAC, AIF, AIFF, FLAC, M4A, MP3, WAV, and WMA

Max size: 50 MB

Maximum number of channels: 1 (mono) or 2 (stereo).

Address

Store structured data for physical addresses such as street names, city, state/province, postal code, and country.

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.

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 }
]

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" type.

Media Gallery

Store multiple images or videos in each field.

You can save the following image file types: JPG, PNG, SVG, and GIF

You can save the following video file types: AVI, MPEG, MPE, MP4, MKV, WEBM, MOV, OGV, VOB, M4V, 3GP, DIVX, and XVID

Max size of each media file: 25 MB

Color

Store HEX numbers that represent colors in each field.

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 so they can send an email to the relevant address.

To create dynamic links that open the visitor's mail client:

1. Create a URL field type in your collection for storing the email addresses.

2. Add the email addresses to the field with mailto: at the beginning of each address (e.g. mailto:support@email.com).

3. Link a button or image to a dataset that connects to this URL field. When visitors click the link, their email client opens with the relevant address in the 'To:' 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?

No, the option to change a field type has been removed. To use a different field type, add a new field and copy your data over.