Mastering Terraform Contains and Strcontains Functions

contains(): Check If It’s In There — Or Burn a Saturday Debugging#

The contains() function checks whether a specific value exists inside a list or a set.

1
contains(list, value) => bool

It returns true if the list contains the value. false if it doesn’t. That’s it.

Sounds basic? Sure. But when your infra logic starts depending on user input, region capabilities, or feature flags, this little guy becomes the bouncer at the front of your Terraform nightclub.

1
variable "region" {
2
  default = "uksouth"
3
}
4

5
variable "vm_size" {
6
  default = "Standard_DS2_v2"
7
}
8

9
data "azurerm_virtual_machine_sizes" "example" {
10
  location = var.region
11
}
12

13
output "is_supported" {
14
  value = contains(data.azurerm_virtual_machine_sizes.example.sizes, var.vm_size)
15
}

strcontains(): When You’re Parsing Strings Like It’s Bash Again#

Now let’s talk about strcontains() — Terraform’s way of answering the question: “Does this string have that other string inside it?”

1
strcontains(string, substr) => bool

Use it when you don’t have a list, just a single string — like an AZ name, tag, or label — and want to match patterns.

1
strcontains("us-east-1b-optimal", "optimal") // returns true

1
locals {
2
  is_optimal_zone = strcontains(var.availability_zone, "optimal")
3
}

Gotchas (That Bit Me, So You Don’t Have To)#

• contains() cares about exact values. Case-sensitive. No fuzzy matches.
• strcontains() won’t match regex or wildcards. It’s pure substring.
• Maps don’t work with contains() the way you want. Only lists and sets. If you try contains({ key = "val" }, "key") — expect disappointment.
• Nulls can mess with results. Validate your variables, or wrap with coalesce() if needed.

Bonus: Validate with Style#

Want to enforce logic on inputs? Use validation blocks with these functions.

1
variable "az" {
2
  type    = string
3
  default = "us-east-1b-optimal"
4

5
  validation {
6
    condition     = strcontains(var.az, "optimal")
7
    error_message = "Only 'optimal' AZs are allowed for this deployment."
8
  }
9
}

Now Terraform fails early — with a message that makes sense — instead of crashing halfway through your infra plan.

TL;DR#

• Use contains() when working with lists or sets.
• Use strcontains() for substring checks in single strings.
• Combine them with validation, count, or for_each for clean, safe logic in your modules.
• Don’t guess. Test.

Social Channels#

• 🎬 YouTube
• 🐦 X (Twitter)
• 🎨 Instagram
• 🐘 Mastodon
• 🧵 Threads
• 🎸 Facebook
• 🧊 Bluesky
• 🎥 TikTok
• 💻 LinkedIn
• 📣 daily.dev Squad
• ✈️ Telegram
• 🐈 GitHub

Community of IT Experts#

• 👾 Discord

Is this content AI-generated?

No. Every article on this blog is written by me personally, drawing on decades of hands-on IT experience and a genuine passion for technology.

I use AI tools exclusively to help polish grammar and ensure my technical guidance is as clear as possible. However, the core ideas, strategic insights, and step-by-step solutions are entirely my own, born from real-world work.

Because of this human-and-AI partnership, some detection tools might flag this content. You can be confident, though, that the expertise is authentic. My goal is to share road-tested knowledge you can trust.