What are CMS Properties?
CMS properties are related information that can be added to CMS items (content like articles or products). You can set properties for each model (group of items) and register individual values for each item.The following property types are available:
Text
Number
Select (single choice)
Multi-select (multiple choices)
Boolean (on/off)
Color
Image
Reference (refer to another model)
How to Add CMS Properties
Open the CMS dashboard.
Select a model and item.
On the item list screen, click [+] and choose the property type.
Edit the property label and click add.
Set property values for each item.
Tip: To display added properties on a page, you need to link the data to a box in the editor. For details, see Dynamic Pages > Linking CMS Data.
You can also add properties from the item details screen.
Editing Labels and Deleting Properties
Access the CMS dashboard.
Select a model and item.
Click on the property label in the item list screen.
Here you can change the label or delete the property itself. Be careful when deleting a property, as it cannot be undone.
You can perform similar operations on the item details screen.
Types of Properties
1. Text Property
Text properties allow you to register string values. You can choose between single-line and multi-line display formats. The line break setting can be adjusted later in the property settings screen.
Use Cases
Display article subtitles
Show product descriptions
Register external URLs
How to Set Up
When adding a property, select either [No Line Breaks] or [With Line Breaks]
Enter text and save
For properties with line breaks enabled: Use Shift/Option + Return to add line breaks (Shift or Alt on Windows)
Note: When switching from "with line breaks" to "no line breaks", <br> tags will appear only in the CMS dashboard, while line breaks will remain intact in the editor, live preview, and published site. Please manually remove the <br> text if needed.
Example of using a text property as a URL:
2. Image Property
A property for adding uploaded images. For supported image formats, please refer to File formats and sizes that can be uploaded to Studio.
Use Cases
Display featured images for articles
Show product photos
3. Boolean Property
A property for setting on/off (true/false) values.
Use Cases
Show/hide "New" badges (with display conditions)
Mark "Recommended" products (with display conditions)
Change specific content styles like colors or sizes (with conditional styling)
4. Number Property
A property for adding numerical values.
Use Cases
Style number settings (padding, font size, etc.)
5. Color Property
A property for setting colors (color codes). Registered color properties can be used for box fills and text box colors.Use Cases
Color coding by category
Setting tag background colors
6. Select Property
A property for selecting a single item from registered options. Useful for categorizing items and displaying tags.
Features
Enables filtering CMS lists by specifying a single item as a filter condition
Unlike reference properties, select properties don't have slugs (unique URLs), so you cannot create independent page paths with them
Cannot be used as Dynamic Filters
If you need dynamically filtered listing pages by categories or tags, consider using reference properties instead
Use Cases
Setting single labels like "Reservation Required" or "No Reservation Needed" for event posts
How to Set Up
Choose "Select" when adding a property
Register the options
Select one item for each content item and save
The select property is particularly useful when you need simple categorization without the need for separate landing pages for each category.
7. Multi Select Property
A property for selecting multiple items from registered options. Useful for filtering CMS lists with multiple conditions simultaneously (up to 5 property items).
Features
You can filter CMS list items by specifying a single criteria condition.
Unlike reference properties, select properties cannot create independent page paths as they don't have slugs (unique URLs).
Select properties cannot be used as Dynamic Filters.
If you need dynamically filtered list pages based on categories or tags, consider using reference properties instead.
Use Cases
Displaying multiple department labels like "HR" and "Accounting" on job posts
Showing multiple skills like "Graphic Design" and "Web Design" on portfolio items
How to Set Up
Select "Multi-select" when adding a property.
Register the available options.
Select the necessary options for each item.
The display order on the website and within the dashboard can be edited via drag-and-drop.
The items at the top represent the display order on the website.
The items at the bottom represent the display order within the dashboard.
8. Reference Property
A property that can reference items from other models, available in single-select or multi-select options.
Features
Properties can have associated information like slugs (unique URLs), allowing you to create independent page paths and display additional images or text for each property item.
You can create category and tag-filtered dynamic list pages.
You can filter CMS list items by specifying single or multiple criteria. For multi-select, you can set up to 5 properties as conditions (AND search) for filtering.
Use Cases
Including writer information (image, name, etc.) in articles
Displaying tags or categories (when creating individual listing pages for each tag/category)
Differences Between Single-select and Multi-select
Single-select:
Allows referencing only one item.
Can be linked to text or image boxes.
Multi-select:
Allows referencing multiple items.
Can only be linked to lists.
Note: It is not possible to change a reference property linked to a list from multi-select to single-select.
If changes between multi-select and single-select are required, the list must be recreated.
Editing and Removing Property Items
Access the CMS dashboard.
Select the model and item.
Edit the added property items on the item list screen.
Standard Properties: Can be edited directly on the item list or detail screen.
Reference Properties: Edit the property itself in the referenced model.
Click the [×] button to remove a set property item.
Updating Items
When property items are edited or removed from published items, their status changes to "Update Available."
To reflect the changes on the live site, update the item's status.
You can perform the same operations on the item detail screen.
