Properties

Custom fields for your content

Properties are custom metadata fields that you can attach to any post type. They extend your content model with additional structured data beyond what sections provide.

While sections define the page content (text, images, layout), properties define metadata and attributes — like a product's price, an event's date, or a team member's job title.

Properties are especially useful because they can be queried and filtered through the API, making them ideal for searchable, filterable content.

Supported data types

Svalla supports several property types to match your data needs:

• String — text values (e.g., job title, location, color)
• Integer — whole numbers (e.g., price, quantity, order)
• Boolean — true/false values (e.g., featured, active, promoted)
• Date — date values (e.g., event date, deadline, release date)
• Array — lists of values (e.g., tags, features, specifications)
• Object — structured data with nested fields

Choose the type that best matches your data. The type determines how the field appears in the editor and how it can be queried.

Add properties to post types

Properties are configured at the post type level. To add a property:

• Open the post type settings
• Go to the Properties tab
• Click "Add Property"
• Set the title, key, and type
• Configure options like required, searchable, or default value

Once added, the property appears in the post editor sidebar for every post in that type. Editors can set the value when creating or editing content.

Query content by custom fields

One of the most powerful features of properties is the ability to filter content through the API:

• Find all products with price under 50
• Get all events after a specific date
• List only featured articles (boolean = true)
• Search posts by a specific string property

The GraphQL API supports filtering by property values, combining property filters with category filters, and sorting by property values. This enables advanced content discovery and dynamic listings on your frontend.

Reusable field configurations

Input groups are reusable sets of fields that can be shared across post types and projects. They define a group of related inputs that always appear together.

For example, you might create an input group for:

• Address fields — street, city, postal code, country
• Social links — Facebook, Twitter, LinkedIn, Instagram URLs
• Contact info — phone, email, website

Input groups are defined with a JSON structure and can be assigned to multiple post types, ensuring consistency across your content models.