Skip to main content

Space Properties

Space properties are Valuecase variables that can be used as placeholders to (automatically) personalize Spaces.

Written by Jan Niklas Wick

Space properties let you personalize Valuecase Spaces with your own structured data. You can use them to automatically insert customer-specific information into templates and to control which content is shown during Space creation.

This article explains how to create space properties, choose the right property type, use them as placeholders, build dynamic links, and apply them in content automation.

There are three kinds of space properties:

Type

Description

Example

Short text

Free text input

Customer segment

Dropdown

Select one value from a predefined list

Currency β†’ Euro

Checkboxes

Select one or more values from a predefined list

Purchased Services β†’ Enterprise Software, Consulting Services

πŸ’‘ Internal Properties are the other available type of properties. In contrast to Space properties, Internal properties are automatically attached to all existing & new spaces and can carry default values. The main use case is the Kanban View. Learn more

(The video in this article may show an older UI. The functionality is still applicable.)

Set up space properties

In order to set up space properties, you need to have Admin permissions in Valuecase.

To add new space properties:

  1. Go to βš™οΈ Dashboard > Space Properties.

  2. Click on '+Add Property' and select "Space Property"

  3. Next, enter a Display Name.

  4. Choose property type (see above). If you select Dropdown or Checkboxes you are asked to provide at least 1 option.

  5. Decide whether the Property must be supplied during Space creation (or is optional).

The Display Name is the label shown in Valuecase when the property is used in templates, spaces, and creation flows.

Edit or delete properties

To edit or delete a property, open the three-dot menu next to the property and select Edit.

A property can only be deleted if it is not used in any template. This helps prevent broken placeholders or automation rules.

Use space properties in Spaces and Templates

Space properties can be used in two main ways:

  • as placeholders in text, links, and embeds

  • as input values for content automation rules

Space properties as placeholders in text, links, and embeds

There are two ways to insert a space property:

Method

Best for

How it works

Placeholder chip via the UI

Standard personalization text without any formatting

Insert the property from the editor via '+Placeholder'

{{key_name}} inline

Advanced use cases such as formatted text, dynamic links, and embeds

Type the property key manually in double curly braces

Insert a placeholder chip

To insert a space property as a standard placeholder:

  1. Click into a supported text field

  2. Open the rich text editor

  3. Select + Placeholder

  4. Choose the space property you want to insert

The placeholder will be inserted at the selected position.

How to use {{key_name}} inline

To use a space property inline, simply type its key name in double curly braces:

{{key_name}}

Example:

Hello {{contactFirstName}}

You can use inline placeholders in:

  • any text fields where placeholders are supported

  • Quick Action Buttons in the Action Plan Block (learn more)

  • HTML embeds in the Media Block (learn more)

Why use {{key_name}} instead of a placeholder chip

The key difference is how the value is handled. With a placeholder chip, the property value is treated as plain text.

With {{key_name}}, the value is rendered directly. This means that if the property value contains HTML-based formatting, that formatting can be preserved instead of being shown as plain text.

This makes {{key_name}} the better choice for:

Space properties for content automation

Space properties can also be used in content automation rules to show or hide content automatically during Space creation.

You can apply automation rules to pages, blocks, and block items. Depending on the property type, available operators may differ.

For multi-select properties, common rule types include:

  • Contains at least one of: show content if any selected value matches

  • Contains all of: show content only if all specified values are selected

  • Is equal to only one of: show content if exactly one specified value is selected

  • Is equal to all of: show content only if the selected values exactly match the defined set

This helps you tailor content to each customer. For example, you can show an API onboarding page only when a customer selected Enterprise and API Integration.

Provide values for space properties during Space creation

When you create a Space from a template that uses space properties, you will be asked to provide values for those properties. These values are then used to populate placeholders and apply automation rules.

Space creation via the dashboard

If you create a Space in Valuecase and choose a template that contains space properties, you will provide the values during the final step of Space creation.

Space creation via API

If you create Spaces via API, use the property key names to pass values.

For multi-select properties, pass the values as an array, for example:

["Enterprise Software", "Consulting Services"]

View and edit property values after Space creation

You can still update property values after a Space has been created.

To do this:

  1. Open the Space

  2. Go to Space Settings

  3. Open the Space Properties tab

  4. Update the relevant values

Any related placeholders and visibility rules will update automatically.

Did this answer your question?