Verification code text messages provide security authentication for scenarios such as logon and registration. When you request a verification code template, you must follow the content and variable rules.
If the content you send involves illegal activities or regulatory violations that result in regulatory investigations, user complaints, or negative public opinion, Alibaba Cloud Communications has the right to abort or stop providing services to you, take measures such as permanent account suspension, and deduct funds from your order or account as liquidated damages, in accordance with Article 5 of the Service Agreement. If these funds are insufficient to cover the loss incurred by Alibaba Cloud, Alibaba Cloud has the right to seek further compensation from you. Please strictly adhere to all applicable regulations, strengthen your own business security, and send text messages responsibly.
Quick links: Template rules | Variable rules | Examples
Template rules
When you write the content for a verification code template, follow these rules for content, format, and links:
Category | Specifications |
Content rules | An SMS template must clearly state the message content and reflect its actual sending scenario.
|
Format rules |
|
Link rules | Verification code templates do not support links. |
Restricted services for template requests |
|
SMS template rules may be adjusted at any time based on requirements from the Ministry of Industry and Information Technology (MIIT) and carriers. The final review result is definitive.
Sample template content
Enter the exact content of the text message you want to send. Use ${variable_name} as a placeholder for variables. You can customize variable names, but they must reflect the purpose of each variable.
Application Scenario | Sample template |
Logon/Verification |
|
Registration |
|
Reset password | Your dynamic code is |
Change information | The verification code is |
You can also use the console to
generate template content with one click or
view more sample templates. Using these sample templates increases the approval rate.
Variable rules
Verification code templates support only single-variable and double-variable templates. Multi-variable templates are not supported.
Single-variable templates: You can create custom single-variable templates.
Variable property
Variable name
Variable rule
Numbers only
Custom.
Example: ${code}, ${time}
Single variable, 4 to 6 digits long.
Combination of numbers and letters or letters only
Custom.
Example: ${code}
Single variable, 4 to 6 characters long.
Double-variable templates: You cannot customize or modify them. When you request a verification code template, click Recommended Templates and select a double-variable template.

Submit for review
Log on to the Template Management page in the console to request an SMS template.
Review time: After you submit an SMS template, the review is typically completed within 2 hours. For requests that involve government agencies or enterprises, you must provide a landline number for verification. Alibaba Cloud completes the review for these requests within two business days. If your template is not reviewed after several business days, check whether the landline number you provided is correct.
Review hours: 9:00 to 21:00, Monday to Sunday. Reviews are postponed during public holidays.
You can activate the dedicated DingTalk group for Short Message Service to view SMS template review notifications and set up alert pushes.
You cannot modify a template after it is approved.
Common reasons for review failure
The following table lists common reasons why verification code templates are rejected and the suggested actions.
Category | Rejection reason | Suggested action |
Content is vague or cannot be verified | The template does not reflect the business content and its purpose is unclear. | Use actual business content for testing. Note If the template has no business content and is only for testing, you can request one of the following templates:
|
The template's application scenario is unclear. | In the scenario description, provide the business scenario where the text message is used or an online link to your business, such as your app, official account, or mini program. Also, provide a complete message sample with the variables populated. For logon scenarios, you can provide a test account and password. | |
The app, official account, or mini program was not found in the app marketplace. | In the scenario description, provide the correct link to your scenario or a link to your business in any app marketplace. If the product is not yet online, you cannot request a template. | |
Template content or format does not meet the rules | The verification code SMS template includes unsubscribe instructions. | Remove the unsubscribe instructions and resubmit. |
The verification code SMS template contains multiple variables. | Remove the extra variables and resubmit. Verification code templates support only one or two variables. Double-variable templates cannot be customized. The variable can contain only 4 to 6 digits or letters. Example: Verification code: ${code}. | |
The verification code SMS template contains irrelevant content. | Remove the content that is not related to the verification code from the template. | |
The verification code keyword is missing. | Check the template content. The template must include one of the following keywords: 'verification code', 'registration code', 'check code', or 'dynamic code' (dynamic password). | |
The notification SMS template includes promotional content. | Remove the promotional content and resubmit, or request a promotional SMS template. | |
The template contains:
|
| |
The content involves finance, dating, religion, games, or similar topics. |
| |
The content involves a third party. | If you send text messages on behalf of a third party, you must submit the third party's corporate certificates and a letter of authorization. In the Associated Signature section, select an existing signature that corresponds to the submitted documents, or request a new signature with the relevant documents. | |
Variable does not meet the rules | The variable content is vague. | We recommend that you clarify the parameter description. Example: |
The variable format is incorrect. | Correct the format and resubmit. The variable rules are as follows:
| |
The variable property is selected incorrectly. | Select the appropriate variable property based on your business scenario. | |
Incorrect template type | The selected template type does not meet the requirements. | Request a verification code, notification, or promotional SMS template based on your business scenario. For more information about specific scenarios, see Scenarios. |
References
For more information about how to request an SMS template, see Request an SMS template.
For more information about the rules for calculating SMS content length and the limits on sending frequency, see SMS sending rules.
For answers to common questions about SMS templates, see the SMS template FAQ.