Skip to main content
Flexibility and customization are key aspects we aim to provide in Hyperline. To achieve this, we allow you to define custom properties so that you can represent and store all the extra data you need. Custom properties can be defined and associated with customer, product, plan, and subscription entities. Furthermore, values are structured with a range of types including text, number, boolean, date, and a select list of predefined values.

​
Use cases

Custom properties provide a wide range of possibilities. For example, they can be used to represent additional fields for your customers, integrate extra billing details into your plans, assist in entitlement and feature flagging by representing features activatable on specific products or subscriptions. These are just examples, and they can be customized to meet any specific needs based on your use case.

​
Create a custom property

1

Navigate to Settings then Custom properties

2

Click on New custom property

3

Fill the form

You will be asked to enter a name, a slug (a unique identifier mainly used for technical integration using the API), the property type, and the entities on which the custom property will be available.Additionally, you can decide to activate this custom property only for technical purpose, meaning that it won’t be editable in the Hyperline’s interface but will only be available through the API. When this option is untoggled, the field is both editable in the interface and the API.

​
Managing custom property values

When created, the custom property can be found on the related entity in the interface. On the customer, the custom properties appear in the bottom of the information panel on the customer details page.
For products and plans, they will appear in a dedicated box on the product/plan in the ‘Advanced settings’ section.
For subscriptions, you can set the value in the second step of the subscription assignment flow.

​
Filtering by custom properties

You can filter customers and subscriptions by their custom property values in the respective list views. When you create custom properties for customers or subscriptions, filter controls automatically appear in the filters dropdown on the Customers and Subscriptions pages. The filter type depends on the custom property type:
  • Boolean properties: Display as a dropdown with On and Off options
  • Select properties: Display as a dropdown with the predefined values you configured
To filter by custom properties:
  1. Navigate to the Customers or Subscriptions page
  2. Click the filters dropdown
  3. Select the custom property filter you want to apply
  4. Choose the value to filter by
The list will automatically update to show only records matching your selected criteria.
Only boolean and select-type custom properties are available as filters. Text, number, and date properties cannot be used for filtering in the interface.
Custom properties marked as “API only” will not appear in the filter panel.

​
Displaying custom properties on hosted pages

For now it is only available for the customer portal page. You can decide to select which custom properties to display on the customer portal by navigating to the Settings > Hosted pages section.

​
Using the API

You can create, retrieve and manage custom properties using the API. Additionally, you can retrieve the values using the custom_properties field when fetching a customer, product, subscription.

​
How this differ from the properties field on customer and subscription

The properties field was introduced in the initial step, but it lacks structure (e.g., it is not named or typed) and is not manageable through the interface for non-technical users. While this field can still be utilized to store unstructured technical details on those entities, we recommend using custom properties when possible to ensure safety and better manageability.