Announcing Customizable Comment Notifications

Terrateam now lets you customize how automated comments appear in your pull requests, giving you full control over comment behavior.

As Terraform repositories grow and teams scale, pull requests can quickly fill up with plan outputs. Without customization, these comments can become noisy and hard to manage.

The Problem with Comment Clutter

With Terrateam, every plan and apply run automatically posts its results back to the pull request. That keeps everyone informed, but different teams want those updates handled in different ways:

• Some teams want to preserve the complete history of all operations
• Others prefer the cleanest possible PR interface
• Many need different strategies for different parts of their infrastructure

Comment Strategies

The notifications configuration provides three strategies for managing Terrateam comments:

1. Minimize (Default)

Collapses older comments while keeping them accessible. This maintains a clean PR interface while preserving the full history.

notifications:
  policies:
    - tag_query: ''
      comment_strategy: 'minimize'

2. Append

New comments are added without modifying previous ones, creating a complete timeline of all infrastructure changes.

notifications:
  policies:
    - tag_query: ''
      comment_strategy: 'append'

3. Delete

Previous Terrateam comments are removed when new ones are created, keeping only the most recent information visible.

notifications:
  policies:
    - tag_query: ''
      comment_strategy: 'delete'

Granular Control with Tag Queries

You can apply different strategies to different parts of your infrastructure using tag queries:

• Use append for production environments where audit trails are critical
• Apply delete for development workspaces to reduce noise
• Keep minimize for staging environments as a middle ground

Here's an example configuration that demonstrates this flexibility:

notifications:
  policies:
    # Production - keep everything for audit
    - tag_query: 'dir:production/**'
      comment_strategy: 'append'
    
    # Development - keep it clean
    - tag_query: 'dir:dev/**'
      comment_strategy: 'delete'
    
    # Staging - balanced approach
    - tag_query: 'dir:staging/**'
      comment_strategy: 'minimize'
    
    # Everything else defaults to minimize
    - tag_query: ''
      comment_strategy: 'minimize'

Availability

Customizable comment notifications are available now for all Terrateam users. Update your .terrateam/config.yml file to configure your preferred comment strategy.

For feedback or questions, visit our GitHub repository.