Since 1998 5000+ Clients 99.9% Uptime TRAI Certified
📝 DLT GUIDE · CONTENT TEMPLATES

DLT Template Registration: Rules, Tags & Examples

How to get an SMS content template approved on DLT in 2026: which category to choose, what the fixed text must contain, how many variables you can use, and 13 example templates written to current rules.

✅ Facts last verified 29 Oct 2026⏱️ 11 min read📚 Sources: TRAI directions; Airtel, Vi and BSNL portals

A DLT content template is the pre-approved wording of one SMS: fixed text plus up to three typed variables. You register it under your entity on any operator's DLT portal, choose a category (promotional, transactional or service), link it to one approved header, and tag each variable, for example {#numeric#} on Airtel or {#num#} on Vi and BSNL. Whitelist any link or callback number first. If a message does not match an approved template exactly, it is rejected at scrubbing.

1. Where content templates fit

The order is fixed: entity first, then headers (sender IDs), then content templates against those headers. Each approved template gets a template ID, and the operator's scrubbing engine checks every message against it. Consent templates are separate: they hold the wording used to collect explicit consent, and BSNL accepts them only in English.

2. Pick the right category

The category decides who you can reach and which header type you need. These are the operators' own definitions, as written in the current Vi and BSNL manuals and the TCCCPR amendment of 12 February 2025:

CategoryWhat it coversStatus in 2026
PromotionalAdvertising for a product or service. Sent to non-DND numbers, or to numbers whose digital consent is registered on DLT.Open
TransactionalTriggered by a transaction the subscriber performed and sent within about 30 minutes. Includes OTPs from banks and non-bank entities such as apps and e-commerce sites, plus balance and refund alerts.Open
Service ImplicitInformation about a product or service the customer already uses: delivery updates, warranty, recalls, appointment and attendance messages, periodic balance alerts. Must not be promotional.Open
Service ExplicitService messages that need the customer's explicit, verifiable consent.Closing (see below)
GovernmentCommunications from government bodies, treated as a separate category since February 2025.Government entities only

One rule from the February 2025 amendment catches many businesses: promotional content mixed with anything else makes the whole message promotional. A delivery update ending "use code SAVE10 on your next order" is promotional. Borderline cases are worked through in transactional vs promotional SMS.

Service Explicit is being wound down; the details are not settled (Medium confidence). Airtel's portal says "Registration of new SE templates with alphanumeric headers will be discontinued", that category changes are allowed "only for SI and Transactional templates", and that "SE-Promo category migration will not be permitted". The current Vi and BSNL manuals no longer offer the category. Fast2SMS reports SE templates were moved to Promotional on 10 March 2026; we found no TRAI document for that date. Our reading: if a message needs explicit consent or carries an offer, register it as promotional.

3. Rules for the fixed text

Once a template is approved, only the variable values may change. Write the fixed text with that in mind:

  • Put your brand, trade or legal name in the text. Vi has required it in every content template since 11 October 2020, and OTP templates without a brand were invalid after 31 October 2020. Jio's template screen asks: "Have you inserted your brand/trade/legal name in the requested template?"
  • Keep at least 40% of the template as fixed text. Airtel states this alongside its 2–3 variable rule.
  • No trailing line break. Airtel will not save the template until you "fix line break at the end of the template content".
  • No duplicates. Airtel rejects content that is already registered on the same header with "Template content is already present."
  • Choose the message type. Text for English, Regional for Tamil, Hindi or other Unicode; each language is a separate template.
  • Length. Airtel's template field accepts up to 2,000 characters; you pay per SMS part sent.
  • Treat promotional wording as final. Jio states promotional templates cannot be changed.

4. How many variables you can use

SourceVariable limit
TRAI, 16 Feb 2023Two variables, with a third allowed "in case of exigency". Variables must not be contiguous.
TRAI, 12 May 2023 and 18 Nov 2025More than three only on justification, and every variable must be pre-tagged for its purpose.
Airtel portal"2–3 Variable are allowed with at least 40% of static content in the template."
Vi manualThree; more needs justification. Until the justification flow is released, up to 15 are allowed as an "interim relaxation only".
BSNL manualThree; "more than 3 variables are allowed only after proper justification".
Jio TrueConnectNo limit published. The template screen shows the variable count and asks you to confirm.

Variables need fixed text between them; Vi and BSNL allow only {#alp#} variables back to back. Every variable carries a type tag, and the names differ by portal. The examples below use Airtel's; on Vi and BSNL swap {#numeric#}→{#num#}, {#alphanumeric#}→{#alp#}, {#url#}→{#urg#}, {#urlott#}→{#uro#}, {#email#}→{#eml#}; {#cbn#} is the same. Length limits per tag are in our variable tagging guide.

Keep units in the fixed text ("Rs. {#numeric#}") so number variables carry only digits, and never design a variable that could hold a whole sentence.

Vi's and BSNL's current manuals say: "A new template can be linked to only one (1) header", chosen from headers in the same category. Older templates linked to several headers must be trimmed to one with Replace Headers before any change. BSNL's older FAQ page still says a content template "can be used with multiple headers"; the newer manual governs new registrations. If you send the same OTP from two sender IDs, register two templates. On Airtel, a template sent with a header it is not linked to fails with error 614; see our DLT error codes guide.

6. Whitelist links and numbers before you register

Since 1 October 2024, messages with URLs, APK or OTT links that are not whitelisted have been blocked. Callback numbers were deferred, but the 18 November 2025 direction now scrubs tagged {#cbn#} values against whitelisted numbers. Portals call this CTA (call-to-action) whitelisting:

CTA typeFormat the portals accept
Static URLFull URL with http:// or https://. No shortener links. No URL that redirects elsewhere: Airtel says redirecting URLs "will be rejected during the approval process".
Dynamic URLWhitelist the part up to the ?. Variable parameters may come only after it, and dynamic paths before the ? are not supported (Vi, BSNL).
Short URLYour short domain plus your header, e.g. https://shrt.com/HEADER/abc. Airtel requires the whitelisted base to end with "/" and does not allow numeric headers in short URLs.
APK / app linkMust end in .apk or .ipa
Mobile number12 digits starting with 91
LandlineStarts with 0, 11 digits
Toll-freeStarts with 1800 or 1860, 8–13 digits
Short code3–6 digits

Whitelist once on any portal and it is shared with every operator; Vi and BSNL charge nothing extra. Airtel warns that messages "will fail during scrubbing if the whitelisted URL does not exactly match".

7. How long template approval takes

PortalPublished target for content templates
ViThe registrar validates within 60 minutes, and any discrepancy is reported within 72 hours (Vi FAQ).
BSNLSame wording as Vi: 60 minutes, with discrepancies reported within 72 hours.
AirtelNone published for content templates. Consent templates: "Approval may take up to 24 hours."
JioNone published.

Provider guides commonly quote 1–3 working days, but no operator commits to that. Vi's "Generate score" tool says "a higher score increases the chance of automatic approval".

8. Thirteen example templates

Each example has a brand name, at most three tagged variables and fixed text between them. "Acme" names are placeholders for your registered brand; values in {#url#}, {#urlott#} and {#cbn#} must be whitelisted.

DLT templateTransactional · Airtel tags
{#numeric#} is your OTP to log in to AvanceZone. It is valid for 10 minutes. Do not share it with anyone. -AvanceZone

Your OTP for the payment of Rs. {#numeric#} at Acme Stores is {#numeric#}. It is valid for 5 minutes. Never share your OTP. -Acme Stores

A refund of Rs. {#numeric#} for your Acme Stores order {#alphanumeric#} has been processed to your original payment method. -Acme Stores
DLT templateService Implicit · Airtel tags
Your Acme Stores order {#alphanumeric#} has been shipped. Track it here: {#url#} -Acme Stores

Your Acme Stores order {#alphanumeric#} will be delivered today. For help, call {#cbn#}. -Acme Stores

Dear {#alphanumeric#}, your appointment at Acme Clinic is confirmed for {#alphanumeric#}. Please arrive 10 minutes early. -Acme Clinic

Reminder: your appointment with {#alphanumeric#} at Acme Clinic is tomorrow at {#alphanumeric#}. To reschedule, call {#cbn#}. -Acme Clinic

Dear Parent, the term fee of Rs. {#numeric#} for {#alphanumeric#} is due on {#alphanumeric#}. Please pay at the school office or online. -Acme School

Dear Parent, {#alphanumeric#} was absent from Acme School today. Please contact the class teacher if this is unexpected. -Acme School

Your Acme Fibernet bill of Rs. {#numeric#} for account {#alphanumeric#} is due on {#alphanumeric#}. Please ignore if already paid. -Acme Fibernet
DLT templatePromotional · Airtel tags
Weekend sale at Acme Stores: flat {#numeric#}% off on home appliances till {#alphanumeric#}. Shop now: {#url#} T&C apply. -Acme Stores

Book visits and view lab reports on the Acme Clinic app. Download it here: {#urlott#} -Acme Clinic
DLT templateTransactional · Regional (Tamil)
உங்கள் AvanceZone உள்நுழைவு OTP {#numeric#}. இது 10 நிமிடங்களுக்கு மட்டுமே செல்லுபடியாகும். யாரிடமும் பகிர வேண்டாம். -AvanceZone

Submit sample values that pass validation: 482913 for an OTP, AZ10234 for an order, 31 Oct 2026 for a date. Number variables take digits only, so 1,499.50 fails; send whole rupees. Whether punctuation such as : or / passes alphanumeric scrubbing on every operator is not published, so test first.

9. Why templates get rejected

ReasonWhere it comes fromFix
Untagged {#var#} in a new templateTRAI 18 Nov 2025; Airtel: new templates must be pre-taggedTag every variable
More than three variables without justificationVi, BSNL manualsMerge fixed parts into the text, or justify
Under 40% fixed textAirtel portalAdd context around the variables
Two non-alphanumeric variables side by sideTRAI 2023; Vi, BSNLPut fixed text between them
No brand nameVi FAQ; Jio template screenAdd your registered brand or legal name
Offer wording in a transactional or service templateTCCCPR amendment, Feb 2025Register it as promotional
Link, app link, number or email without a whitelisted CTAAirtel: "Values not found for type… register for more in Manage CTA"Whitelist first, then register
URL in an alphanumeric sampleAirtel: "Url found for 'Text without URL' variable type"Use {#url#} for links
Redirecting or non-matching URLAirtel CTA rulesWhitelist the final URL itself
Duplicate content on the same headerAirtel: "Template content is already present."Reuse the existing template ID
Trailing line breakAirtel template screenDelete the final newline
Header from a different categoryVi, BSNL: only same-category headers are listedRegister a header of the right type

10. After approval

Store the template ID as text, exactly as the portal shows it. On AvanceZone, messages are normally checked against your approved templates before they leave; a mismatch returns HTTP 422 with error_code: TEMPLATE_MISMATCH. Our PHP SMS guide shows how to fill templates in code. Keep templates maintained: Airtel requires quarterly verification of headers and templates, and Jio an annual self-certification.

Related DLT guides

FAQ

DLT Template Registration: FAQ

How many variables can a DLT template have?
Plan on three at most. Vi and BSNL allow three, with more only on justification (Vi temporarily allows up to 15). Airtel says 2–3 variables with at least 40% fixed text.
Can one DLT template be used with more than one header?
Not for new templates on Vi and BSNL: their manuals allow one header per new template. If two sender IDs send the same message, register the template twice.
How long does DLT template approval take?
Vi and BSNL publish a 60-minute registrar target, with discrepancies reported within 72 hours. Airtel and Jio publish no target for content templates. Provider guides quote 1–3 working days; that is not an operator commitment.
Is {#var#} still accepted in DLT templates?
Not for new templates. Since TRAI's 18 November 2025 direction every variable must be typed, and old {#var#} templates must be migrated. See our variable tagging guide.
Can I edit an approved DLT template?
No. Only variable values change between messages. New fixed text means a new template and a new template ID.
Do I need a separate template for Tamil or Hindi messages?
Yes. Register the Tamil or Hindi wording as its own template with the Regional (Unicode) message type.
What happened to Service Explicit templates?
The category is being closed: Airtel has stopped new ones with letter headers and the current Vi and BSNL manuals no longer offer it. One provider reports a move to Promotional on 10 March 2026, which we could not confirm with TRAI.
Do URLs in a template need whitelisting?
Yes. Since 1 October 2024, messages with non-whitelisted URLs, APK or OTT links are blocked. Whitelist once on any portal; it is shared with every operator.
TEMPLATES DRAFTED FOR YOU

Send Us Your Messages, Get Back Approvable Templates

We write templates in the right category with tagged variables, whitelist your links and register them under your entity. Then we connect them to our DLT-compliant gateway. AvanceZone has worked from Sulur, Coimbatore since 1998; see bulk SMS in Coimbatore.