Understand Shopify WhatsApp integration from the ground up connecting orders to automated customer messaging.
What Are WhatsApp Templates?
A WhatsApp template is a pre-approved message format that allows businesses to send proactive messages to customers outside the standard 24-hour customer service window. Think of them as permission slips from Meta that let you initiate conversations first.
Why Templates Need Approval
WhatsApp isn't like email or SMS where you can send whatever you want. Every template must be reviewed and approved by Meta before you can use it. This happens for one critical reason: protecting users from spam and scams.
Here's what happens when you submit a template:
- You create a template in WhatsApp Business Manager or via API
- Meta receives your submission for review
- Both automated systems and human reviewers check your template
- Approval typically takes 1–24 hours (sometimes up to 48 hours)
- You receive an approval or rejection notification
Pro Tip: Meta reviews templates daily, and they can approve, pause, or reject templates at any time even after initial approval if they receive negative user feedback.
Why Meta Rejects WhatsApp Templates
Meta's review team isn't trying to make your life difficult. They're essentially asking four critical questions about every template:
The 4-Question Framework
1. Is the purpose obvious without conversation context?
Templates can be deployed at massive scale, so Meta needs to know your message makes sense on its own.
2. Could this template be abused?
Too vague? Too many variables? Deceptive link tricks? These raise red flags.
3. Does it match the declared category?
If you claim it's a "utility" message but it's clearly promotional, expect rejection.
4. Does it violate any policies?
Sensitive identifiers, regulated products, spam indicators, or policy violations = automatic rejection.
According to WhatsApp's official Business Messaging Policy, businesses must have explicit opt-in consent and honor opt-out requests. Templates that could violate user trust or safety get rejected immediately.
Top 15 Reasons for WhatsApp Template Rejection
Let's get into the nitty-gritty. Here are the most common rejection reasons we see (and how to fix them):
1. Category Mismatch
What went wrong: You selected "Utility" but wrote a sales pitch.
Utility templates are strictly for updates, alerts, and confirmations that follow a user action. If you're trying to drive sales, announce offers, or boost engagement that's marketing.
The fix:
- Use Marketing for any promotional content
- Use Utility only for transactional updates
- Use Authentication exclusively for OTP codes
Example – Wrong:
Category: Utility
Message: "Special offer! Get 50% off today only! Shop now!"
Example – Right:
Category: Marketing
Message: "Hi {{1}}! Enjoy 50% off this weekend. Use code SAVE50 at checkout: {{2}}"
2. Variable Parameter Errors
This is the #1 technical reason for rejection. Variables are those {{1}}, {{2}} placeholders you use for personalization.
Common mistakes:
- Variables with special characters (#, $, %)
- Variables at the start or end of messages
- Non-sequential numbering ({{1}}, {{2}}, {{4}} – where's {{3}}?)
- Variables placed directly next to each other
- Missing sample values
The fix:
Bad: "{{1}}, your order {{2}}{{3}} is ready!"
Good: "Hi {{1}}, your order #{{2}} is ready for pickup!"
Bad: "{{1}} thanks for shopping with us"
Good: "Thanks for shopping with us, {{1}}!"
Important: Always provide clear sample values. Instead of just "{{1}}", show what goes there:
"{{1}}" – sample: "John Smith".
3. Threatening or Urgent Language
Even phrases that seem harmless can trigger rejection.
Rejected phrases:
- "Act now or lose access"
- "Your account will be suspended"
- "Immediate action required"
- "Final warning"
The fix: Keep your tone calm and factual.
Bad: "URGENT! Your account will be LOCKED unless you verify NOW!"
Good: "Hi {{1}}, please verify your account by {{2}} to maintain access."
4. Requesting Sensitive Information
Never ask for:
- Passwords, PINs, or security codes
- Full credit card numbers
- Social Security numbers
- National ID numbers
- Financial account details
The fix: Direct users to secure portals instead.
Bad: "Please reply with your credit card number to process payment"
Good: "Complete your payment securely here: https://yourbrand.com/checkout/{{1}}"
5. Prohibited Products or Services
Meta blocks templates promoting:
- Alcohol, tobacco, weapons, or drugs
- Gambling or adult content
- Cryptocurrency (in some regions)
- Unregulated pharmaceuticals
- Counterfeit goods
The fix: Don't promote restricted items. Period.
6. Shortened or Invalid URLs
Rejected link types:
- bit.ly, tinyurl, or any URL shorteners
- wa.me links (WhatsApp direct links)
- URLs not from your verified business domain
- Redirects or tracking links
The fix:
Bad: "Track order: bit.ly/abc123"
Good: "Track order: https://yourbrand.com/orders/{{1}}"
7. Duplicate Content
If your template body and footer match an existing template exactly, the duplicate gets rejected.
The fix: Make each template unique. Even small changes work different CTA buttons, different wording, or different variables.
8. Vague or Unclear Purpose
Templates with too many variables or unclear intent get flagged as potential spam.
The fix: Be specific about what the message is for.
Bad: "Hello {{1}}, your {{2}} is {{3}} for {{4}}"
Good: "Hello {{1}}, your appointment is confirmed for {{2}} at {{3}}"
9. Spelling and Grammar Errors
Meta may reject templates that look unprofessional or contain obvious errors.
The fix: Proofread carefully. Use spell checkers. Have someone else review your templates before submission.
10. Formatting Issues
Common problems:
- Multiple sequential line breaks
- ALL CAPS SHOUTING
- Excessive emojis (more than 10)
- Text in italics or bold within variables
- Mismatched curly braces
The fix: Keep formatting clean and professional.
11. Wrong Language Selection
If you select "English" but include Spanish text, rejection is guaranteed.
The fix: Match the selected language to your actual content. Don't mix languages in a single template.
12. Missing Sample Values for Media
If your template includes images, videos, or documents, you must upload sample files.
The fix:
- For images: Upload a high-resolution sample
- For videos: Provide a sample video file
- For documents: Use PDF format only (most universally accepted)
13. Button Configuration Errors
Common button mistakes:
- Button labels exceeding 25 characters
- More than 3 quick reply buttons
- More than 2 call-to-action buttons
- Button URLs not matching your verified domain
- Undefined button types
The fix: Keep button text under 20 characters. Use only verified domain URLs. Don't exceed button limits.
14. Mentioning Competitor Brands
Meta doesn't allow you to name other brands or services in your templates.
The fix: Focus only on your own products and services.
15. Unverifiable Claims or Guarantees
Promising things you can't prove gets templates rejected.
The fix: Remove guarantees. Use honest, specific language instead of marketing hyperbole.
Bad: "Guaranteed to cure all health problems!"
Good: "Supports your wellness journey with proven ingredients"
Category Selection Guide: Marketing vs Utility vs Authentication
Choosing the wrong category is one of the top rejection reasons. Let's break down exactly when to use each category.
Marketing Templates
Use when:
- Promoting products or services
- Announcing sales or offers
- Sharing newsletters or updates
- Increasing brand awareness
- Driving engagement or conversions
Examples:
- "Flash sale: 40% off everything this weekend!"
- "New product launch: Check out our latest collection"
- "Exclusive offer for loyal customers"
Important: Starting April 2025, Meta automatically reclassifies templates if you pick the wrong category. If they change your "Utility" to "Marketing," you'll pay higher messaging rates.
Utility Templates
Use when:
- Confirming transactions
- Sending account updates
- Providing order status
- Sharing appointment reminders
- Sending payment receipts
Key requirement: Must follow a specific user action or request.
Examples:
- "Your order #12345 is confirmed"
- "Appointment reminder: January 28 at 2 PM"
- "Payment received: $49.99 for Invoice #789"
Common mistake: Trying to sneak promotional content into utility templates to save on costs. Don't do this – Meta catches it, and you'll get rejected or reclassified.
Authentication Templates
Use when:
- Sending OTP codes
- Verifying logins
- Confirming security actions
Restriction: Meta controls the body text format. You cannot customize it beyond the OTP code itself.
Example:
Your verification code is: {{1}}
This code expires in 10 minutes.
Variable Parameter Best Practices
Variables are powerful for personalization, but they're also the biggest source of formatting errors. Here's how to use them correctly.
Formatting Rules
DO:
- Use sequential numbering: {{1}}, {{2}}, {{3}}
- Place variables within sentences, not at edges
- Provide clear sample values
- Keep variables meaningful
DON'T:
- Start or end messages with variables
- Place variables next to each other
- Skip numbers in sequence
- Use special characters inside variables
- Make variables too vague
Sample Values Matter
When creating templates, especially through API, your sample values are crucial. Meta uses these to understand your template's purpose.
Bad sample:
"Hi {{1}}, your {{2}} is {{3}}"
Sample: "Hi name, your thing is status"
Good sample:
"Hi {{1}}, your order #{{2}} will arrive on {{3}}"
Sample: "Hi Sarah Johnson, your order #ORD-12345 will arrive on January 30, 2025"
Maximum Variables
While WhatsApp doesn't officially limit variables, best practice is:
- Body text: 5–7 variables maximum
- Header: 1 variable maximum
- Buttons: 1 variable per button URL
Too many variables make your template look spammy and increase rejection risk.
Pre-Submission Checklist: Get Approved on First Try
Use this checklist before submitting any WhatsApp template:
Template Name
- Lowercase letters only
- Numbers and underscores allowed
- Descriptive and unique
- No spaces or special characters
Category Selection
- Marketing: For promotions and offers
- Utility: For transactional updates only
- Authentication: For OTP codes only
- Category matches actual content
Language & Content
- Selected language matches content
- No mixing multiple languages
- Proper grammar and spelling
- Professional tone (no all caps)
- No threatening or urgent language
Variables
- Sequential numbering ({{1}}, {{2}}, {{3}})
- Not at message start or end
- Not next to each other
- Clear sample values provided
- No special characters in variables
Links & URLs
- Full URLs (no shorteners)
- From verified business domain
- No wa.me links
- HTTPS protocol
Buttons (if applicable)
- Labels under 25 characters (aim for 20)
- Max 3 quick reply buttons
- Max 2 call-to-action buttons
- Button URLs from verified domain
- All button types defined
Media (if applicable)
- Sample file uploaded
- High-resolution images
- PDF format for documents
- File size under limits
Policy Compliance
- No sensitive data requests
- No prohibited products
- No competitor mentions
- No unverifiable claims
- No duplicate content
Pro Tip: Review your template in WhatsApp Business Manager preview mode before submitting. It shows exactly how your message will look to customers.
How to Appeal Rejected WhatsApp Templates
Got rejected? Don't panic. Here's exactly what to do:
Step 1: Check the Rejection Reason
- Go to Meta Business Manager
- Navigate to Business Support Home
- Select your WhatsApp Business Account
- Click on Rejected Template Messages
- Find your template and view the Policy Issue explanation
Step 2: Fix the Issue
Based on the rejection reason:
- Format errors: Create a new template with corrected formatting
- Category mismatch: Resubmit with correct category
- Policy violation: Revise content to comply with WhatsApp policies
- Duplicate content: Make template unique
Important: You cannot edit and resubmit the same template. You must create a new one with a different name. WhatsApp blocks template name reuse for 30 days after rejection.
Step 3: Request a Review (If Wrongly Rejected)
If you genuinely believe your template was incorrectly rejected:
- Select the rejected template in Business Support Home
- Click Request Review
- Choose an Appeal Reason from available options
- Provide detailed explanation
- Click Submit
Appeal timeline:
- Initial review: 24–48 hours
- Appeal review: 24–72 hours
- No response after 72 hours: Contact WhatsApp support
What Happens After Approval?
Once approved, your template status changes to:
- Active - Quality Pending: Can send, awaiting customer feedback
- Active - High Quality: Ready for scale, minimal negative feedback
- Active - Medium Quality: Usable, but has some negative feedback
- Active - Low Quality: At risk of being paused or disabled
Monitor your template performance. Templates can be paused or disabled even after approval if they receive blocks, spam reports, or negative user feedback.
Best Practices for Long-Term Success
Want templates that consistently get approved? Follow these guidelines:
1. Start with Utility Templates
Build your foundation with transactional messages first:
- Order confirmations
- Shipping notifications
- Appointment reminders
- Payment receipts
These have higher approval rates and establish good account quality.
2. Create Reusable Template Structures
Design templates that work across multiple campaigns:
Hi {{1}}, [specific message] {{2}}. [CTA] {{3}}
3. Test Before Scaling
- Submit 1–2 templates initially
- Wait for approval
- Review any rejections
- Refine your approach
- Then create templates at scale
4. Monitor Template Performance
Track these metrics in WhatsApp Business Manager:
- Delivery rate
- Read rate
- Response rate
- Block/report rate
Low engagement = risk of template being paused.
5. Keep Customer Experience First
Ask yourself:
- Would I want to receive this message?
- Is this genuinely helpful?
- Is the timing appropriate?
- Am I respecting user preferences?
If the answer is "no" to any of these, revise your template.
Tools & Platforms for Template Management
Managing templates manually can be tedious. Here are solutions:
WhatsApp Business Manager
- Free, official Meta tool
- Template creation interface
- Approval tracking
- Performance analytics
API Providers
- Twilio: Content Template Builder with visual interface
- Infobip: WhatsApp template management API
- Yellow.ai: Template builder with AI suggestions
- MessageBird: Multi-channel template system
Automation Platforms
- Fufa.ai: WhatsApp automation with template management
- Wati.io: CRM with integrated templates
- Aisensy: Template library with approval tracking
Pro Tip: Most platforms offer template libraries with pre-approved examples you can customize for your business.
FAQ
Q: How many WhatsApp templates can I create?
New accounts can create up to 250 templates. Verified WhatsApp Business Accounts (WABAs) can create up to 6,000 approved templates. This limit increases as your account quality improves with consistent policy compliance and low spam rates.
Q: Can I edit a WhatsApp template after it's approved?
No. Once approved, templates cannot be edited. If you need changes, you must create a new template with a different name and submit it for approval. The old template can be deleted after the new one is approved.
Q: What happens if I get multiple templates rejected?
Multiple rejections can impact your account quality score. This may result in:
- Slower approval times for future templates
- Lower messaging limits
- Stricter reviews on subsequent templates
- Potential account restrictions if policy violations are severe
Always fix the underlying issues before submitting new templates.
Q: How do I know which category to choose for my template?
Use this simple decision tree:
- Is it an OTP or login code? → Authentication
- Does it follow a specific user action (order, booking, payment)? → Utility
- Is it promotional, marketing, or unsolicited? → Marketing
When in doubt, Meta may reclassify your template, so being honest about intent saves time.
Q: Can I use emojis in WhatsApp templates?
Emojis are allowed and can improve engagement. However:
- Keep it under 10 emojis per template
- Use them meaningfully, not decoratively
- Ensure they match your brand tone
- Don't use inappropriate or confusing emojis
Example: "Your order is on the way!" works great.
Q: Why was my template rejected for "duplicate content"?
Meta rejects templates if the body and footer text exactly match an existing approved template. Even if you created both templates yourself, duplicates aren't allowed (except for Authentication templates).
Make each template unique with different wording, variables, or calls-to-action.
Q: How long does the appeal process take?
Template appeals typically take 24–72 hours for Meta to review. If you don't receive a response within 72 hours, contact WhatsApp Business Support through your Meta Business Manager account.
Q: Can I reuse a rejected template name?
No. WhatsApp blocks template name reuse for 30 days after rejection. You must create a new template with a completely different name. This prevents rapid resubmission of the same rejected content.
Q: What's the difference between "paused" and "rejected" templates?
- Rejected: Template failed initial review and was never approved. You need to fix issues and submit a new one.
- Paused: Template was previously approved but is temporarily blocked due to negative user feedback (blocks, spam reports). It may auto-resume after 3–6 hours or be permanently disabled.
Q: Do I need technical knowledge to create WhatsApp templates via API?
While API integration requires some coding knowledge (JavaScript, Python, etc.), many platforms like Twilio, Wati, and TryInLoop provide visual template builders that handle the API calls for you. If you're comfortable with basic API concepts, the official WhatsApp Business API documentation provides clear examples.
Q: Can I test templates before submitting them?
Use the preview feature in WhatsApp Business Manager to see how your template will appear on mobile devices. However, you cannot send test messages until the template is approved. Some API providers offer sandbox environments for testing.
