How to fix There is no function named trimprefix in Terraform

TerraformBEGINNERMEDIUMUpdated Dec 30, 2025· 96 views

The trimprefix function is unavailable in your Terraform version. This error occurs when using Terraform versions older than 0.12.16 that don't support the trimprefix built-in function for string manipulation.

Quick fix

Fixes There is no function named trimprefix

terraform version
  1. Check your current Terraform version
  2. Upgrade Terraform to 0.12.16 or later
  3. Check module version requirements
  4. Verify trimprefix usage is correct
terraform — error
terraform version
There is no function named trimprefix

What this error means

Terraform provides built-in functions for string manipulation, including trimprefix, which removes a specified prefix from the beginning of a string. When Terraform encounters a call to trimprefix but the function isn't available, it throws the "There is no function named trimprefix" error. This occurs because the trimprefix function was introduced in Terraform 0.12.16. If you're using an earlier version, Terraform's HCL parser doesn't recognize this function and treats it as an undefined function call. Additionally, if you're working with modules or configuration files that expect this function to be available, version mismatches can cause this error.

Typical symptoms

  • Terraform plan or apply fails with "There is no function named trimprefix" error
  • Error appears when running terraform validate or terraform init
  • Configuration files using trimprefix fail to parse
  • Module loading fails because module code depends on trimprefix

Common causes

  1. Using Terraform version 0.12.15 or earlier which predates the trimprefix function introduction
  2. Module or configuration written for a newer Terraform version than what's installed
  3. Version constraint mismatch between required_version and actual installed version
  4. Using a Terraform version that's older than the minimum version required by a module

How to fix "There is no function named trimprefix"

1Check your current Terraform version

Run the version command to see what version of Terraform you have installed:

bash
terraform version

This will output your Terraform version, for example: Terraform v0.12.15 or Terraform v1.5.0. If your version is 0.12.15 or earlier, you need to upgrade.

2Upgrade Terraform to 0.12.16 or later

Download and install a newer version of Terraform from the official HashiCorp releases. The trimprefix function is available in all versions from 0.12.16 onwards.

For most users, upgrading to Terraform 1.x is recommended:

bash
# On macOS with Homebrew
brew upgrade terraform

# On Linux, download from https://www.terraform.io/downloads
# Extract to your PATH, typically /usr/local/bin

After upgrading, verify the new version:

bash
terraform version
3Check module version requirements

If you're using modules from the Terraform Registry or a Git repository, verify they don't require a newer Terraform version than what you have. Check the module's README or source for a required_version constraint.

If a module requires a newer version, either upgrade Terraform or switch to an older version of the module:

hcl
# Example: specify an older module version
module "example" {
  source = "terraform-aws-modules/vpc/aws"
  version = "~> 2.0"  # Use older version compatible with your Terraform
}
4Verify trimprefix usage is correct

Once you've upgraded to Terraform 0.12.16 or later, verify your trimprefix usage is correct:

hcl
# Syntax: trimprefix(string, prefix)
locals {
  resource_name = "dev-my-database"
  without_prefix = trimprefix(local.resource_name, "dev-")  # Returns "my-database"
}

output "name" {
  value = local.without_prefix
}

Run terraform validate to check for syntax errors:

bash
terraform validate

Advanced notes

The trimprefix function is part of Terraform's string manipulation functions introduced in version 0.12.16. Related functions include trimsuffix (removes suffix), trim (removes from both ends), and trimspace (removes whitespace). If you need to work with older Terraform versions, you can use the replace() function with regex as a workaround: replace(local.resource_name, "/^dev-/", ""). However, upgrading to a supported Terraform version is strongly recommended for better compatibility, security updates, and access to new features.

Frequently asked questions

What does "There is no function named trimprefix" mean?
Terraform provides built-in functions for string manipulation, including trimprefix, which removes a specified prefix from the beginning of a string. When Terraform encounters a call to trimprefix but the function isn't available, it throws the "There is no function named trimprefix" error. 16.
How do I fix "There is no function named trimprefix"?
The trimprefix function is unavailable in your Terraform version. This error occurs when using Terraform versions older than 0.12.16 that don't support the trimprefix built-in function for string manipulation.
What causes "There is no function named trimprefix"?
Using Terraform version 0.12.15 or earlier which predates the trimprefix function introduction Module or configuration written for a newer Terraform version than what's installed Version constraint mismatch between required_version and actual installed version
Is the "There is no function named trimprefix" error serious?
It is a medium-severity error — more of a blocker than a risk. The steps above resolve it.

Official resources & further reading