You create custom property definition that evaluates a regular expression when you want service catalog users to provide validated data on the catalog request form.

For example, to add an alphanumeric text box where the requesting user provides an application or function name that is limited to five to ten characters with no special characters. For this scenario, you use a regular expression custom property configured to something similar to ^[a-zA-Z0-9]{5,10}$.


  • Ensure that you have a regular expression that validates the provided values as expected.

  • Log in to vRealize Automation as a tenant administrator or fabric administrator.


  1. Select Administration > Property Dictionary > Property Definitions.
  2. Click the New icon (Add).
  3. Enter the options.




    Enter a value using a standard naming convention for the new property name such as my_grouping_prefix.my_property_name.


    The label is populated based on the name. You can change the label to provide a more readable name.


    The action custom properties are only available in the current tenant. To make them available in another tenant, you must configure them when you are logged in to that tenant.


    Describe the intent of the property definition and any other helpful information about the property.

    Display order

    The number that you enter controls how the property name appears on the request form. The following ordering rules apply:

    • The display order applies only to properties that are configured with Prompt User or Show in Request Form settings.

    • All properties with a display order appear before properties with no order index.

    • Properties with a display order are sorted from lowest to highest order index value. You can use negative numbers.

    • All properties are ordered alphabetically, with all display ordered properties appearing before non-display ordered properties.

    • If two properties have the same display order value, then they are sorted alphabetically.

    Data type

    Select String in the drop-down menu.


    Select No in the drop-down menu.

    Display as

    Select Textbox in the drop-down menu.

    Valid user input

    Enter the regular expression.

  4. Enter a value in the testing text box to verify that the expression works.
  5. Click OK.


The custom property definition is added to the list and it is available to add to a blueprint.

What to do next

Add the custom property to a machine blueprint. See Add a Custom Property or Property Group as a Blueprint Machine Property.