Manage properties and secrets

2 minute read

Create, configure, and manage properties and secrets to store configuration values and sensitive data that workflows can access without hardcoding values in your code.

Properties store key-value pairs for configuration data like API endpoints, deployment regions, or repository URLs. Secrets encrypt sensitive values like passwords, tokens, and credentials. Refer to Understanding platform configuration for details on how properties work with environments and inheritance.

You need appropriate permissions in your organization to manage properties. Properties inherit through the organization hierarchy and affect all child organizations.

Navigate to your organization’s Configurations > Properties for all property management tasks.

Access properties

The Properties page displays property names, types (Property/Secret), values, sources (Local/Inherited/Overridden), modification dates, and descriptions. Use search, sort, and filter controls to locate specific properties.

Create a property

  1. Select Create property and enter the property name (alphanumeric and underscores only).

  2. Configure the data type, value, and optional settings (Secret encryption, Prevent override).

  3. Select Save.

Properties are available in workflows as ${{ vars.PROPERTY_NAME }} or ${{ secrets.SECRET_NAME }}.

Manage property inheritance

When your organization inherits properties from a parent organization, you might need different values for your specific context. For example, a parent organization might set a staging server URL, but your team needs to use a different staging environment. You can override inherited property values without affecting the parent organization or other child organizations.

Properties created in a parent organization appear as Inherited in child organizations. You cannot delete or edit inherited properties directly, but you can override their values. Properties you create appear as Local and can include a Prevent override option to lock the value for child organizations.

For details on how inheritance works across organizations, refer to Inheritance and override principles.

Inherited properties from parent organizations can be overridden locally without affecting other organizations. Use the ellipsis menu next to any property to:

  • Create override: Set a local value for inherited properties

  • Edit: Modify overridden or local property values

  • Remove override: Restore inherited values

  • Delete: Remove original properties (irreversible)

Property changes may affect workflows that reference them. Deletion is irreversible.