Collection Fields
Each field type can be configured in the Content Manager interface, allowing you to tailor the data entry process to your specific needs.
Basic Fields
Basic fields in the Content Manager are essential for defining the structure of your content. The two mandatory basic fields are:
- Collection Name: This field is used to specify the title or name of the entry.
- Slug: This field is used to define a URL-friendly version of the name, which helps in creating clean URLs for your content.
These fields are automatically included when you create a new collection item and are essential for organizing and referencing your content.
Custom Fields
Custom fields allow you to extend the functionality of your collections by adding specific types of data that suit your needs.
Text
Purpose: For adding short pieces of text.
Configuration: Specify the field label, help text, and validation rules such as required or maximum length.
- Default Value: Enter a fallback value that will be used if the field is left empty.
- Character Limit: Set the minimum and maximum number of characters allowed.
- Required: Tick to set the field as mandatory.
How to Display: Connect the text field to any text element.
Rich Text
Purpose: For adding formatted text with various styling options.
Configuration:
- Default Value: Enter a fallback value that will be used if the field is left empty.
- Character Limit: Set the minimum and maximum number of characters allowed.
- Required: Tick to set the field as mandatory.
How to Display: Connect the rich text field to any text element.
Image
Purpose: For uploading and displaying images.
Configuration:
- Image Type: Select how the image will be sourced.
- Media: Upload an image directly from your media library.
- Image URL: Link to an image using an external URL.
- Image Format: Restrict the accepted image format. Select All Formats to accept any or choose any combination of JPG, PNG, and GIF.
- File Size Limit: Set the minimum and maximum file size allowed.
- Required: Tick to set the field as mandatory.
How to Display: Connect the image field to an image element.
Video
Purpose: For embedding video content.
Configuration:
- Video Type: Select how the video will be sourced.
- Media: Upload a video directly from your media library.
- Video URL: Link to a video using an external URL.
- Video Formats: Restrict the accepted video format. Select All Formats to accept any or choose any combination of MP4, MOV, and AVI.
- File Size Limit: You can set the minimum and maximum file size allowed.
- Required: Tick to set the field as mandatory.
How to Display: Connect the video field to a video element.
Purpose: For storing email addresses.
Configuration:
- Default Value: Enter a fallback value that will be used if the field is left empty.
- Required: Tick to set the field as mandatory.
How to Display: Connect the email field to any text element.
Phone
Purpose: For storing phone numbers.
Configuration:
- Default Value: Enter a fallback value that will be used if the field is left empty.
- Required: Tick to set the field as mandatory.
How to Display: Connect the phone field to any text element.
Number
Purpose: For storing numerical values.
Configuration:
- Number Format: Select integer, decimal, or any format.
- Default Value: Enter a fallback value that will be used if the field is left empty.
- Allow Negative Numbers: Tick to allow negative numbers.
- Required: Tick to set the field as mandatory.
How to Display: Connect the number field to any text element.
Date
Purpose: For selecting dates.
Configuration:
- Default Value: Enter a fallback value that will be used if the field is left empty.
- Required: Tick to set the field as mandatory.
How to Display: Connect the date field to any text element.
Time
Purpose: For selecting times.
Configuration:
- Default Value: Enter a fallback value that will be used if the field is left empty.
- Required: Tick to set the field as mandatory.
How to Display: Connect the date field to any text element.
Switch
Purpose: To add a toggle or switch option (e.g., on/off).
Configuration:
- Default Value: Enter a fallback value that will be used if the field is left empty.
- Required: Tick to set the field as mandatory.
How to Display: Filter & display collection items based on switch value.
Option
Purpose: To select from predefined options.
Configuration:
- Options: Define the choices available in the dropdown. Click Add New Option to add a new choice. For each option, you can:
- Set as Default – Set the option as the pre-selected value.
- Duplicate – Create a copy of the option.
- Rename – Rename the option.
- Delete – Remove the option.
- Mark Required: Tick to set the field as mandatory.
How to Display: Connect the option field to any text element.
URL
Purpose: For storing web addresses.
Configuration:
- Default Value: Enter a fallback value that will be used if the field is left empty.
- Required: Check to set the field as mandatory.
How to Display: Connect the URL field to any text, button, or even image element, enabling dynamic linking to web pages directly from your content manager.
File
Purpose: For attaching a file to a collection item, such as a PDF, document, or downloadable resource.
Configuration:
- Default Value: Enter a fallback value that will be used if the field is left empty.
- Required: Check to set the field as mandatory.
How to Display: Connect the file field to a text or button element to allow visitors to download or access the file.
Gallery
Purpose: The Gallery field in Kirki allows you to upload and manage multiple images for a single collection item, ideal for showcasing media-rich content like project galleries, product photos, etc.
Configurations:
- Image Type: Select how the image will be sourced.
- Media: Upload an image directly from your media library.
- Image URL: Link to an image using an external URL.
- Image Format: Restrict the accepted image format. Select All Formats to accept any or choose any combination of JPG, PNG, and GIF.
- Required: Tick to set the field as mandatory.
Learn more about Dynamic Image Gallery.
Reference Field
A Reference Field lets you connect a single item from one collection to another. It’s perfect for one-to-one relationships – like assigning an Instructor to a Course, or a Contributor to a Project.
Multi-Reference Field
A Multi-Reference field forms a one-to-many relationship, where one item can link to multiple items in another collection.
This enables advanced relational setups like one course to multiple tags or multiple instructors, etc.
Learn more about Collection References.
Was this page helpful?