Template quality rating

Updated: Jun 17, 2026

Every template has a quality rating based on usage, customer feedback, and engagement. Templates can have the following ratings, as reported by the API:

• GREEN — Indicates high quality. The template has received little to no negative feedback from WhatsApp users. The template can be sent.
• YELLOW — Indicates medium quality. The template has received negative feedback from multiple WhatsApp users, or low read-rates, and may soon become paused or disabled. Message templates with this status can still be sent.
• RED — Indicates low quality. The template has received negative feedback from multiple WhatsApp users, or low read-rates. The template can be sent, but is in danger of being paused or disabled soon. Address the issues that WhatsApp users report.
• UNKNOWN — Indicates a quality score is still pending, because it has yet to receive WhatsApp user feedback or read-rate data. The template can be sent.

Newly created templates have a quality score of UNKNOWN. WhatsApp updates the rating automatically as it collects usage, feedback, and engagement signals over time.

Quality ratings factor into template pacing and template pausing, which can affect template delivery. If a template continuously receives negative feedback or low engagement, it can eventually affect the template's status. If the status changes to anything other than APPROVED, the template cannot be sent in template messages unless its APPROVED status is restored.

Get template quality rating via API

Use the Template API and request the quality_score field to get a template's quality score.

Example request

The following example requests the quality_score field from the Template API for a single template:

curl 'https://graph.facebook.com/v25.0/1105258428396250?fields=quality_score' \
-H 'Authorization: Bearer EAAJB...'

Example response

The Template API returns the template's quality_score field, including the score and the date it was last updated:

{  
  "quality_score": {  
    "score": "GREEN",  
    "date": 1758754645  
  },  
  "id": "1387372356726668"  
}

Get template quality rating via WhatsApp Manager

The Manage templates⁠ panel in WhatsApp Manager also displays template quality ratings for templates that have an approved status:

• Active - Quality pending (equates to an UNKNOWN quality score)
• Active - High quality (equates to a GREEN quality score)
• Active - Medium quality (equates to a YELLOW quality score)
• Active - Low quality (equates to a RED quality score)

See also

• About your WhatsApp Business message template's quality rating⁠