Airtel DLT variable pre-tagging: how to tag variables in old templates

Airtel DLT variable pre-tagging means giving every {#var#} in your old Airtel templates a type, such as numeric or url, and a sample value. Airtel has emailed businesses to do this for all their legacy templates (old templates that are already approved). There are two ways to do it on the Airtel DLT portal: tag many templates at once with an Excel file, or tag one template at a time with the Tag Variable link. This guide shows both, step by step.

What Airtel is asking you to do

Airtel’s email asks for four things:

  • Download your legacy templates and review them.
  • Give each variable the right type for the data it carries, and a sample value.
  • Keep to 3 variables per template. More than 3 needs a business justification that Airtel approves. Airtel DLT support can tell you how to submit it.
  • Upload the updated templates back on the DLT portal.

Airtel says templates that are not updated will not be eligible for migration and may not stay usable under the new rules. The email gives no date. It asks for it at the earliest. For a line-by-line reading of the email, see the Airtel legacy template migration email explained.

Why Airtel DLT templates need variable tagging now

On 18 November 2025, TRAI directed all operators to make sure every variable in every SMS template is pre-tagged with its type. A plain {#var#} could carry anything, even a scam link. Operators first check messages in “logger mode”: the SMS is still delivered and a mismatch is only recorded. Once that period ends, a message whose variables do not match their tags is rejected and not delivered.

Before you start

  • Whitelist your links and numbers first. A CTA (call to action) is a link, app link, callback number or email address you have registered on DLT. For url, urlott, cbn and email variables, the sample value is picked from your approved CTAs. So add them in MANAGE CTA on the Airtel DLT portal before you begin. See what CTA whitelisting is and how to whitelist URLs and callback numbers.
  • Tag carefully. Airtel allows migration only once per template. You cannot change the type later.

Method 1: tag many templates with the Airtel DLT Excel upload

Use this when you have many templates. The portal gives you a ready Excel file. You fill a few columns and upload it back.

  1. Open MANAGE TEMPLATES and click Download

    Log in to the Airtel DLT portal. In the left menu, click MANAGE TEMPLATES. On the SMS page, click Download at the top right.

    Airtel DLT portal SMS templates page with MANAGE TEMPLATES in the menu and the Download button highlighted
    Airtel DLT portal: MANAGE TEMPLATES and the Download button (screenshot from Airtel’s SOP).
  2. Choose Download with no variable tagged

    The Download Templates pop-up has three options. Pick Download with no variable tagged. You can also choose a date range. Click Download.

    Download Templates pop-up on the Airtel DLT portal with Download All, Download with no variable tagged and Download templates with no brand mapped
    Pick the second option, Download with no variable tagged.
  3. Get the file from ALL ACTIVITIES

    The portal prepares a pre-filled Excel file inside a zip. Open the ALL ACTIVITIES tab. When your request shows Activity Type Download and Status Completed, click Download in the Action column.

    ALL ACTIVITIES tab on the Airtel DLT portal with a completed Download request and a Download link
    The file is ready when the request shows Completed.

    Only eligible templates are in the file: status Registered, at least one {#var#}, and not migrated yet. If a template is missing, it failed one of these. Do not add rows yourself.

  4. Fill the type and value columns

    Open the Excel. Template Dlt Id, PE ID (your business entity ID on DLT), SMS Header, Old Content Type, Template Content and the Var1, Var2 columns are already filled. Do not change them. You fill only these:

    • New Content Type: pick from the dropdown.
    • Var1 Type, Var2 Type and so on: pick email, numeric, alphanumeric, cbn, url or urlott.
    • Var1 Value, Var2 Value and so on: a sample value. Type it for numeric and alphanumeric. For cbn, url, urlott and email, pick one of your approved CTAs from the dropdown.
    Airtel DLT pre-tagging Excel with columns Template Dlt Id, PE ID, SMS Header, Old Content Type, New Content Type, Template Content and Var columns
    The pre-tagging Excel. You fill New Content Type and the Type and Value column for each variable.
  5. Upload the file

    Go back to the templates page and click Upload. Click Choose file or drag and drop your file, then click Upload. The file must be .xlsx (CSV is rejected) and 5 MB or less, with the headers exactly as downloaded and each Template ID only once.

  6. Check the results and fix failed rows

    Open ALL ACTIVITIES again. Your upload shows a status such as Completed or Partially Complete, with counts like “Success: 2, Failed: 498, Pending: 0”. Click Download to get the error file. It has a Status and a Rejected Reason for each row. Fix and upload only the failed rows again. Small files are processed quickly. Big files can take a few minutes.

    Airtel DLT ALL ACTIVITIES tab showing an upload that is Partially Complete with Success 2 and Failed 498
    An upload that partly failed. Download the error file to see why each row failed.

Example: how filled rows look

The first template is Airtel’s own example. The other two belong to a sample shop, Demo Traders.

Template Content Variable Type Value
Hi {#var#}, your OTP is {#var#}. Var1 alphanumeric Aman
Var2 numeric 123456
{#var#} is your Demo Traders login OTP. Do not share it with anyone. Var1 numeric 482910
Hi {#var#}, your Demo Traders order {#var#} is confirmed. Track it here: {#var#} Var1 alphanumeric Priya
Var2 alphanumeric ORD4821
Var3 url Your tracking link, picked from the CTA dropdown

For these rows, New Content Type stays the same as Old Content Type: T (Transactional) for the OTPs and SI (Service Implicit) for the order update. After a successful upload, the order template reads:

Hi {#alphanumeric#}, your Demo Traders order {#alphanumeric#} is confirmed. Track it here: {#url#}

Method 2: tag one template with Tag Variable

Use this when you have only a few templates.

  1. Find the Tag Variable link

    Open MANAGE TEMPLATES and stay on the REGISTERED tab. A template with untagged variables shows a Tag Variable link under its content. Click it.

    Registered tab on the Airtel DLT portal with a Tag Variable link under a template's content
    The Tag Variable link appears under templates that still use {#var#}.
  2. Check the Choose Type step

    The first step, Choose Type, shows Selected Header/CLI, Type Of Communication, Category and Website Domain. Click Next.

    Choose Type step of Tag Variable on the Airtel DLT portal with header, Type Of Communication, Category and Website Domain
    Choose Type: check the details and click Next.
  3. Give each variable a type, value and description

    You see one box for each variable: Variable 1, Variable 2, Variable 3. For each one, pick the Type, enter a Value and write a short Description of up to 200 characters, such as “customer name” or “order number”.

    Variable 1, Variable 2 and Variable 3 boxes with Type, Value and Description fields on the Airtel DLT portal
    One box per {#var#} in the template.
  4. Click Next to save

    The portal shows its rules under the boxes: back-to-back variables are allowed only for Alphanumeric, and more than 3 back-to-back Alphanumeric variables may need a justification. When all variables are filled, click Next. The template is saved with tagged variables and stays Registered.

    Variable 3 set to Alphanumeric with a sample value and description, with the portal's variable rules and Next button
    A filled variable, with the portal’s rules below it (screenshot from Airtel’s SOP).

The 6 variable types

Type Max length Use it for Rule
alphanumeric 40 Names, order or booking IDs Letters, numbers and special characters. Cannot start with www, http or https. The only type allowed back to back.
numeric 40 OTP, amount Digits only.
url 120 Website link Must match a CTA registered as a Static, Dynamic or Short URL.
urlott 120 App or OTT link Must match a CTA registered under OTT or APK.
cbn 3 to 14 Callback number Must match a CTA under Number (mobile, landline or toll free).
email 40 Email address Valid email format and a validated CTA.

In the template, each type becomes a tag such as {#numeric#} or {#url#}. For sample templates with each tag, see DLT variable tagging explained.

Rules that make rows fail

  • Changing any fixed text, even one space or one full stop.
  • Adding or removing a variable, or leaving a type or value empty.
  • A sample value that does not fit its type, such as letters in a numeric variable.
  • Two variables side by side with no space or punctuation, unless both are alphanumeric.
  • Adding template rows yourself, or the same Template ID twice.
  • A file that is not .xlsx, is over 5 MB or has changed headers. Then the whole file is rejected.

For each error message and its fix, see Airtel DLT pre-tagging upload errors.

Content type changes during migration

The New Content Type column also sets the template category. Service Explicit (SE) is no longer a valid type, so SE templates move to Promotional (P). Service Implicit (SI) can change to Transactional (T), and T can change to SI. If the type is already right, pick the same type again. For what this means for old SE templates, read Service Explicit removed on Airtel DLT.

After migration

  • Migrated templates are auto approved. There is no separate approval, and they show in the Registered tab.
  • Migration works only once per template, so the tags cannot be changed later.
  • Your Template ID stays the same. Only the variable format in the message changes.
  • In Fast2SMS, open DLT Manager > Content Template and check the template text. If it still shows the old version, add the new text with Add Content Template or Upload Excel using your portal export. See the DLT Manager guide.
  • Fast2SMS reads typed tags like {#numeric#} as normal variables, so you send with variables_values the same way as before.
  • Each value you send must fit its tag, and links and numbers must be your whitelisted CTAs. Otherwise, once logger mode ends, the operator rejects the SMS and the delivery report shows the error. See Airtel SMS error codes.

Stuck on a step? Book a free meeting with our team.

Frequently asked questions

What is Airtel DLT variable pre-tagging?

It is the migration of your old Airtel DLT templates from plain {#var#} to typed variables. Each variable gets a type, such as numeric or url, and a sample value.

Is there a deadline for Airtel DLT template migration?

Airtel’s email gives no date and asks you to do it at the earliest. Once the logger period ends, messages that fail variable checks are rejected, so do not wait.

Can I change a variable type after migration?

No. Airtel allows migration only once per template, so check every type first.

Why is my template not in the downloaded file?

Only templates that are Registered, have at least one {#var#} and are not migrated yet are included. If one is missing, it does not meet one of these conditions.

Do migrated templates need approval again?

No. Templates migrated by Excel or by Tag Variable are auto approved and show in the Registered tab.

Does my Template ID change after migration?

No. The Template ID stays the same. Only the message text changes to the new tags.