Use properties to define variables and secrets at the organization or sub-organization level. A property is a key-value pair used to configure various platform elements such as actions, environments, or integrations.
Typical uses include:
-
Credentials (e.g., usernames, passwords, personal access tokens)
-
SCM metadata (e.g., repository URLs, commit hashes)
-
General configuration (e.g., API endpoints, deployment regions, artifact paths)
-
Supported data types: String, Number, Boolean.
Organization-Level Properties
-
Scope: Available to all applications, workflows, and sub-organizations.
-
Purpose: Define global configurations or shared credentials.
-
Example: ARTIFACT_REPO_URL, LOG_SERVICE_API_KEY
-
Inheritance: Sub-organizations and workflows inherit these properties by default.
Sub-Organization-Level Properties
-
Scope: Restricted to the specific sub-organization.
-
Purpose: Support department-specific or project-specific settings.
-
Example:
FINANCE_TEAM_API_ENDPOINT
,PROJECT_X_JIRA_TOKEN
-
Overrides: Sub-organization-level definitions take precedence over Organization-level ones with the same name.
-
For more information, refer to Properties.