Sample Values
Sample values are the example inputs you attach to each variable in a WhatsApp message template so Meta's reviewers can see the message the way a real customer will receive it. A template like "Hi {{1}}, your order {{2}} ships on {{3}}" is meaningless to a reviewer until you fill it with realistic samples — "Priya", "IQ-48213", "9 July". Meta then reviews the rendered message, not the raw placeholders, which is why good sample values are the difference between a fast approval and a rejection that stalls your launch.
In one line
Sample values are example variable inputs (like a real name, order ID, or date) that you submit with a WhatsApp template so Meta reviews the fully rendered message, not empty {{1}} placeholders.What sample values actually are
Every WhatsApp Business API template can contain variables — numbered placeholders written as {{1}}, {{2}} and so on — that get replaced with dynamic data at send time. But Meta cannot approve a template it cannot fully read, so at submission you must provide one sample value for each placeholder in the body, header, and any URL buttons. These samples are never sent to your customers; they exist purely for the review stage. Meta stitches your samples into the template, reads the finished message, and judges it as a whole for policy, clarity, and category fit. In InfiQ's template builder the sample fields appear inline beside each variable, so you fill them in the same screen where you write the copy.
Why sample values matter for approval and category
Reviewers assess the rendered message, which means your samples directly shape the outcome. Vague or lazy samples — a single letter, 'test', 'xxx', or a placeholder that looks like spam — make the message read poorly and invite rejection or a downgrade in category. This matters commercially because WhatsApp now bills per delivered message by category (marketing, utility, or authentication) rather than per conversation. A template you intended as a low-cost utility notification can be reclassified as marketing if the rendered sample reads promotional, and that reclassification changes what every future send of that template costs. Representative samples that clearly show a transactional, order-tied message help the template land in the category — and the price band — you designed it for.
- One sample is required for each variable in the body, header, and dynamic URL buttons.
- Samples are review-only and are never delivered to customers.
- Realistic samples help Meta place your template in the correct billing category.
- Poor samples are a common, avoidable cause of template rejection and delay.
How to write sample values that pass review
Treat each sample as a real example of the data that variable will hold in production. If {{2}} is an order ID, give it a value shaped like a real order ID from your system, not 'ABC'. If a variable is a currency amount, include the ₹ symbol and a plausible figure. If it is a date, format it the way your customers actually see it. Match the length and tone of real data too — a name variable should hold a real-looking name, not a full sentence — because Meta checks that the rendered message reads naturally and that variables are not being used to smuggle in content that belongs in the fixed template text. Keeping samples consistent with the variable's true purpose also protects you from a subtler failure: a template that passes review with clean samples but breaks in production when the live data doesn't fit the layout you approved.
- Use production-shaped data: a real-looking order ID, name, amount, or date.
- Include units and symbols (₹, %, dates) exactly as customers will see them.
- Keep sample length close to real values so the layout you approve is the one you send.
- Never use variables to hide promotional or policy-sensitive text from the reviewer.
Common mistakes to avoid
The most frequent errors are dummy samples ('test', 'name', a single character), samples that contradict the variable's role, and forgetting a sample entirely — Meta will not accept a template with an unfilled placeholder, so submission simply fails. Another trap is stuffing a variable with content that should have been fixed template text; reviewers read this as an attempt to game the review, and it often triggers rejection across the whole template. Businesses also stumble when a variable's real values vary far more than the single sample suggests, so a template approved with a short sample looks broken once long real-world values flow through. Finally, remember that editing an approved template's variables can send it back for re-review, so getting samples right the first time saves a full approval cycle.
Frequently asked questions
Are sample values ever sent to my customers?+
How many sample values do I need to provide?+
Can bad sample values get my template rejected?+
Do sample values affect what I pay per message?+
What makes a good sample value?+
Will changing sample values on an approved template trigger re-review?+
Where do I enter sample values in InfiQ?+
Get your templates approved the first time
Let an InfiQ onboarding specialist review your sample values and template categories before you submit, so you clear Meta's review fast and message on the pricing you planned for.