Formatting/Variable Errors – Issues with placeholders?

If you're facing Formatting/Variable Errors in your WhatsApp Template, follow these fixes:


1. Use Correct Placeholder Format

  • WhatsApp only supports placeholders in {{number}} format.

  • Example: Hello {{1}}, your order #{{2}} is confirmed!

  • ❌ Avoid special characters: Hello [name], your order is confirmed!Incorrect


🚫 2. No Extra Spaces or Line Breaks

  • Do not add extra spaces before or after placeholders.

  • Example:

    • ✅ Correct: Hi {{1}}, your payment of {{2}} is received.

    • ❌ Incorrect: Hi {{ 1 }}, your payment of {{ 2 }} is received.


📌 3. Ensure Variables are Properly Mapped

  • If sending via API, ensure the values match the placeholders.

  • Example API JSON:

    jsonCopyEdit{
      "name": "order_update",
      "language": "en",
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "John" },
            { "type": "text", "text": "₹500" }
          ]
        }
      ]
    }
  • Mismatched variables → Template fails to send.


🔄 4. Avoid Incorrect Data Types

  • If using media placeholders, ensure the correct type is used.

  • Example:

    • Text: {{1}} = John Doe

    • Image URL: {{1}} = https://image-link.com/sample.jpg

    • Sending text in a media placeholder


🛠 5. Keep Template Language & Placeholders Consistent

  • Ensure template language matches the variables.

  • Example:

    • English Template: Hello {{1}}, your OTP is {{2}}.

    • English Template + Hindi Variables: Hello {{1}}, आपका OTP है {{2}}।May get rejected


🔥 6. Test with a Sample Number

  • Send a test message using WhatsApp Manager or API Sandbox to check formatting.


🆘 7. Check Meta Business API Logs

  • If using API, check response logs for errors like:

    • 470 – Invalid Parameter Format

    • 1006 – Template not found

    • 131026 – Missing or incorrect variables

📌 Meta API Error Codesarrow-up-right


🚀 Fix these & retry your template! Let me know if you need help debugging. 🔥

Last updated