Skip to content
Meta Business PartnerGlossary term

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.

Example variable inputs submitted for template review
What it is
No — review-only
Sent to customers?
One sample each (body, header, buttons)
Required per variable
Template rejection or wrong billing category
Main risk if wrong

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.

See InfiQ pricing

Talk to InfiQ

See how this works on InfiQ

Tell us your use-case — we’ll show it running in a sandbox, usually within a working day.

Step 1 of 2
WhatsApp

Protected by invisible spam checks · replies within 1 working day

Frequently asked questions

Are sample values ever sent to my customers?+
No. Sample values exist only for Meta's review stage. At send time your placeholders are replaced with real, live data from your system, and the samples you submitted are never delivered to anyone.
How many sample values do I need to provide?+
One for every variable in the template — that includes placeholders in the body, in the header, and in any dynamic URL buttons. A template with an unfilled placeholder cannot be submitted for review.
Can bad sample values get my template rejected?+
Yes. Meta reviews the fully rendered message, so lazy samples like 'test' or 'xxx', or samples that make the message read like spam, are a common cause of rejection. Realistic, purpose-matched samples give you the best chance of a fast approval.
Do sample values affect what I pay per message?+
Indirectly, yes. Meta bills per delivered message by category — marketing, utility, or authentication. If your rendered samples make a utility template read as promotional, it can be classified as marketing, which changes the rate that applies to every future send of that template.
What makes a good sample value?+
Data shaped like the real thing: a realistic order ID for an order-ID variable, a plausible ₹ amount with its symbol for a currency field, a properly formatted date for a date field, and a real-looking name for a name field. Match the length and tone your live data will actually have.
Will changing sample values on an approved template trigger re-review?+
Editing a template's variables or content can send it back to Meta for a fresh review, which pauses its availability. It is worth getting your samples right before first submission to avoid an extra approval cycle.
Where do I enter sample values in InfiQ?+
InfiQ's template builder shows a sample field beside each variable on the same screen where you write the message, so you complete copy and samples together before submitting to Meta. Our onboarding team can review your templates before you send them for approval.

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.