---
title: "Set Properties"
description: "Set properties in workflow payload efficiently with our handler. Update, add, or remove properties as needed. (Gitana 4.0)"
product: "Gitana"
version: "4.0"
url: "/documentation/gitana/4.0/engine/workflow/workflow-handlers/set-properties"
---

# Set Properties

Type: `setProperties`

This handler lets you set properties onto the items that are part of your workflow's payload.

The `config` for this handler is as follows:

```
{
    "properties": [{
        "name": "<property name>",
        "value": <value>
    }]
}
```

If a non-null value is provided, it is added to the workflow payload item and the item is saved. If the value is set to null, the property will be removed.

Here is an example where we update the workflow state to "approved". Concurrently, we also removed the "inprogress" property.

```
{
    "properties": [{
        "name": "state",
        "value": "approved"
    }, {
        "name": "inprogress",
        "value": null
    }]
}
```

## See Also

- The [Set Property](/documentation/gitana/4.0/engine/behaviors/actions/set-property.md) action