> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/guardian/workspace/policies/5539-editing-policy-parameters-at-runtime.md).

# Editing Policy Parameters at Runtime

## Editing policy parameters at runtime

This feature lets you modify policy parameters after the policy has been published. First, define which parameters can be edited. To do that, use the new button in the Policy Configurator.

<figure><img src="/files/cVr7CHjLCStWvbcVmweH" alt=""><figcaption></figcaption></figure>

Clicking this button opens a new dialog with dynamic property groups. You can add any number of properties. Each property includes the following fields: **Block**, **Property**, **Visible**, **Apply for**, **Label**, and **Description**.

<figure><img src="/files/e4IYqlyHZNV89GLXWzMq" alt=""><figcaption></figcaption></figure>

The **Blocks** dropdown contains only blocks from the current policy that have at least one editable property. The **Visible** field determines who can modify the property. **Apply for** specifies the roles that receive the change. **Label** and **Short Description** appear in the runtime form for editing policy parameters.

After you configure the policy parameters and publish the policy, a new **Parameter Settings** button appears on the policy.

<figure><img src="/files/iHMIYlhOpTYgOUgy9rKy" alt=""><figcaption></figcaption></figure>

These settings include the parameters configured in the Policy Configurator. Values for editable parameters are stored in a new database table: `policy_parameters`.

<figure><img src="/files/akxA7n2GtXIKUDRHHFHO" alt=""><figcaption></figcaption></figure>

If some parameters are marked as required, this form opens automatically when the user opens the policy.

<figure><img src="/files/2YIezXZrKJ8nErQixhuA" alt=""><figcaption></figcaption></figure>

In this example, the **Information** block can be modified. Before the changes are applied, the text configured in the corresponding property is displayed.

<figure><img src="/files/yruzUDUCB94CMXMp2mKY" alt=""><figcaption></figcaption></figure>

After you add new text to this property, it appears on the page.

<figure><img src="/files/CzWvdR7Gw4pprHmjM85t" alt=""><figcaption></figcaption></figure>

## Endpoints for this feature

1. Retrieve the policy parameter configuration.

```
GET 
/:policyId/parameters/config
```

2. Save policy parameters.

```
POST 
/:policyId/parameters 
[{ 
  blockType: string; 
  blockTag: string; 
  propertyPath: string; 
  visible: string[]; 
  applyTo: string[]; 
  label: string; 
  required: boolean; 
  shortDescription: string; 
  value?: any; 
}]
```

## Related Issues

* [https://github.com/hashgraph/guardian/issues/5539](https://github.com/hashgraph/guardian/issues/1987)