---
title: "__digest"
description: "JMeter __digest function reference: syntax, parameters, and practical examples for parameterizing test plans with dynamic values."
url: https://docs.jmeter.ai/functions/digest/
lastUpdated: 2026-10-01
source: docs.jmeter.ai
---

# __digest

*Also documented in context in the [full Functions and Variables reference](/user-manual/functions/#__digest).*

The digest function returns an encrypted value in the
specific hash algorithm with the optional salt, upper case
and variable name.

| Name | Required | Description |
| --- | --- | --- |
| Algorithm | Yes | The algorithm to be used to encrypt             For possible algorithms See MessageDigest in             [StandardNames](https://docs.oracle.com/javase/8/docs/technotes/guides/security/StandardNames.html)              - MD2 - MD5 - SHA-1 - SHA-224 - SHA-256 - SHA-384 - SHA-512              :::note Spaces are taken into account for `Salt to add` and `String to encode` ::: |
| String to encode | Yes | The String             that will be encrypted |
| Salt to add | No | Salt to be added             to string (after it) |
| Upper Case value | No | Result will             be in lower case by default. Choose true to upper case             results. |
| Name of variable | No | The name of             the variable to set. |

Examples:

```bash
\${__digest(MD5,Errare humanum est,,,)}
```

returns `c49f00b92667a35c63708933384dad52`

```bash
\${__digest(SHA-256,Felix qui potuit rerum cognoscere causas,mysalt,,)}
```

returns `a3bc6900fe2b2fc5fa8a601a4a84e27a079bf2c581d485009bc5c00516729ac7`

## Related

- [Functions and Variables Guide](/topics/functions-and-variables/)
- [Regex Extractor Builder](/tools/regex-tester/)
- [Full Functions Reference](/user-manual/functions/)
- [Component Reference](/user-manual/component-reference/)
