Early Access
This feature is not enabled for all users. If you’d like to try it out, please email our support team for early access.
ConfigStore offers a centralized, secure, organized approach to managing configuration data within Qntrl. It allows you to define parameter values and access them dynamically across different modules and environments in Qntrl, enhancing flexibility, re-usability, and security. Multiple parameters can be organized under a Group for better management.
Key Benefits of ConfigStore
Centralized Management: Store configuration data in one place, eliminating the need for hard-coding values in multiple scripts and functions.
Dynamic Access: Access parameter values dynamically across various environments, reducing the need for manual updates.
Flexibility: Easily update configuration values without modifying each script or function individually.
Enhanced Security: Safely manage sensitive data, such as passwords or API keys, centrally within ConfigStore. With encryption support for parameter values, sensitive data can be securely stored as encrypted values.
Re-usability: Reference parameters by their unique link names from supported modules or environments in Qntrl, promoting consistency and reducing redundancy.
Use Case Example
If you need to use an API key in multiple requests, store it as a parameter named api_key in ConfigStore instead of hard-coding it. You can then reference this parameter in your requests using {{api_key}} or the link name ${<link-name of parameter>}, based on the module where the parameter is used.
When the key changes, update the parameter value in ConfigStore, and the change will be reflected everywhere the parameter is used. This approach ensures that any repeated data in your requests is managed centrally, simplifying updates and enhancing consistency across your workflows.
Parameter and Group Limits
Create a Parameter
To create a new parameter,
Navigate to
(settings) >> Advanced >> ConfigStore >> select ConfigStore. Click the New Parameter button.
Fill in the Parameter Details:
Name: Provide a name for the parameter.
Value: Enter a value for the parameter. This value will be used wherever the parameter is called.
Default Value: Specify a default value. If the parameter value is not defined for any environment instance, this default value will be used to prevent failures due to empty parameter values.
Type: Choose how to store the parameter value in the database.
Visibility: Define where the config store variable can be accessed.
Internal: Used only within Qntrl (scripts, automation, placeholders).
External: Can be accessed via client scripts and APIs, in addition to internal use.
Group: Select an existing group from the drop-down or create a new group by clicking the + icon. If no group is selected, the parameter will be stored under the default group. Learn more about groups.
Scope: Define the parameter values within the Sandbox environment.
The environment scope is applicable only when the Sandbox feature is enabled, allowing you to define parameter values for each environment. If the Sandbox feature is disabled, only the Global scope is available.
Changing visibility from Internal to External in a sandbox project and deploying it will update the setting accordingly.
For further details on managing environment-specific parameter values, refer to the Environment Scope section. Click Save to store the new parameter.
When a parameter is saved, a link name is auto-generated in the Link Name field, and the parameter gets listed in the left pane.

Config Store – ZDK Support in Client Script
The external parameters that can be accessed dynamically across different environments can be retrieved using Client script ZDK methods. This enables environment-aware scripting without hard-coding sensitive or environment-specific data.
When writing Client Scripts, you may need values like API keys, tokens, or other environment-specific configurations. Instead of embedding these directly in your script, you can store them securely in the Config Store and retrieve them at runtime using ZDK.
Benefits:
Keeps scripts clean, secure, and maintainable
Allows config changes without updating scripts
Supports flexibility across environments
Only external parameters from the Config Store can be accessed through Client Script ZDK.
Supported ZDK Methods in Client Script
Below are the supported ZDK methods available for retrieving external parameters in Client Scripts:
Method | Description |
ZDK.QntrlParamAPI.getParamByLinkName(array) | Retrieves parameters using their link names. |
ZDK.QntrlParamAPI.getParamById(array) | Retrieves parameters using their unique IDs. |
ZDK.QntrlParamAPI.getAllParams() | Retrieves all external parameters available in the current environment. |
These methods return the current value associated with the environment in which the script is executed. Learn more about Config Store ZDks for Client Scripts.
Edit a Parameter
Click on the parameter name in the left pane.
On the details page, make the necessary modifications.
Click Save to apply the changes.
Hover next to the parameter name in the left pane.
Click the delete icon.
Confirm your delete action.
