Skip to main content

Space Properties

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

Jan Niklas Wick avatar
Written by Jan Niklas Wick
Updated over a week ago

Space properties allow you to take personalisation of Valuecase Spaces to the next level. In Valuecase, you can add your own space properties that can be used as text placeholders and for content automation. They usually represent information about your buyer or customer, which is then used to automatically personalize your Space.

There are three kinds of space properties:

  • Short text: free text input

  • Dropdown (single‑select): Select a single value from a predefined list (e.g. "Currency" → Euro)

  • Checkboxes (multi‑select): Select one or multiple values from a predefined list (e.g. "Purchased Services" → Enterprise Software; Consulting Services)

These properties can be inserted as placeholders in Templates (both in text as well as in links/button) and used for setting up content automation rules.

(the following video might display an outdated UI, but functionality-wise it is still applicable)

Set up space properties

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

  1. To add new space properties go to ⚙️ Dashboard > Space Properties.

  2. Click on '+Add Property' to add a new space property.

  3. Next, enter a Display Name. The Display Name is the name of the space property that will be displayed in Valuecase whenever it is used, for example when adding the property to a Template or during Space creation.

  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).

Edit properties

To edit or delete properties, simply 'Edit' in the three-dot menu of the space property you want to edit.

Please note that you can only delete a property if it's not used in a Template (see the template count column in the space properties table. We've introduced this safety mechanism to make sure you don't accidentally delete properties that are still in use.

Use space properties in Spaces and Templates

Space properties can be used in two ways: as placeholders for text/ links/ buttons and in content automation to set rules for the visibility of pages, blocks, and media itmes.

Space properties as text placeholder

To insert a space property into a text as a placeholder:

  1. Click in any text field and open the Rich Text Editor by double-clicking or highlighting text where you want to insert the space property.

  2. Select '+placeholder' in the text options bar. Here you will find the system placeholders (Company Name, First Name, Last Name) along with your space properties.

  3. Select the space property you want to insert.

The space property will now be inserted at the respective part of your text. Please double-check if it's inserted in the right place and if the spacing is correct.

Space properties for content automation

Space properties are used as input values for our content automation, that allows you to automatically show or hide content during Space creation, based on predefined rules. When a property is set to multi‑select, define rules in the page automation panel to control the visibility of pages and blocks:

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

• Contains all of: Shows content only if every specified value is selected

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

• Is equal to all of: Shows content if the selected values match the specified set

These options let you target content precisely to your stakeholders, for example, show an API onboarding page only when the client is Enterprise and interested in API Integration.

For further details on how to set up content automation, please read our article on content automation.

Provide values for space properties during Space creation

When you create a Space from a Template that contains space properties, you'll be asked to provide values for these space properties to create the Space. In both cases, the provided input will be automatically populated and applied during Space creation.

Space creation via our dashboard (standard flow)

If you create a Space via the Valuecase interface, and select a Template that contains any space properties, you will be asked to provide values during the last step of Space creation.

Space creation via API

If you are using our API to create Spaces, use the property key names to pass the correct information for Space creation. For multi‑select properties, pass the values as an array, for example: ["Enterprise Software", "Consulting Services"].

View and edit space properties in a Space.

You can still see and update the property values after Space creation. Simply head to the Space Settings and open the Space Properties tab. Here you can update the text value of the space properties. Visibility status of pages and blocks as well as text placeholders, will adjust automatically.

Did this answer your question?