terraform/website/docs/language/functions/trimsuffix.mdx

---
page_title: trimsuffix - Functions - Configuration Language
description: |-
  The trimsuffix function removes the specified suffix from the end of a
  given string.
---

# `trimsuffix` Function

`trimsuffix` removes the specified suffix from the end of the given string, but only once, even if the suffix appears multiple times. If the suffix does not appear at the very end of the string, the original string is returned unchanged.

## Examples

```
> trimsuffix("helloworld", "world")
hello
```

```
> trimsuffix("helloworld", "cat")
helloworld
```

```
> trimsuffix("hello--", "-")
hello-
```

## Related Functions

* [`trim`](/terraform/language/functions/trim) removes characters at the start and end of a string.
* [`trimprefix`](/terraform/language/functions/trimprefix) removes a word from the start of a string.
* [`trimspace`](/terraform/language/functions/trimspace) removes all types of whitespace from
  both the start and the end of a string.