Best Practices

1. Keep Company Names Short

Use short, recognizable company names to save characters and reduce SMS segments.

Good Examples

Code
 
// ✅ Good - Short and clear
company: 'Acme'
company: 'ABC Co'
company: 'TechCorp'

// ❌ Avoid - Too long
company: 'Acme Corporation International Inc.'
company: 'The ABC Company, LLC'

Character Impact

Long company names increase message length:

Code
 
// Long company name - 2 segments
const longResult = renderTemplate(template, {
  company: 'Acme Corporation International',
  code: '482916'
});
console.log(longResult.segments); // 2 segments = $0.04

// Short company name - 1 segment
const shortResult = renderTemplate(template, {
  company: 'Acme',
  code: '482916'
});
console.log(shortResult.segments); // 1 segment = $0.02

Company Name Guidelines

Maximum recommended: 20 characters
Optimal length: 5-10 characters
Use abbreviations: "Corp" instead of "Corporation"
Drop legal entities: Remove "Inc.", "LLC", etc.
Test recognition: Will users recognize your short name?

Validation

Templates enforce a 20-character limit:

Code
 
const validation = validateTemplateData(template, {
  company: 'A'.repeat(25),  // Too long!
  code: '482916'
});

if (!validation.valid) {
  console.log(validation.errors[0].message);
  // "Must be 20 characters or less"
  console.log(validation.errors[0].suggestion);
  // "Use a shorter company name or abbreviation"
}

Brand Recognition

Balance brevity with recognition:

✅ "Amazon" - Instantly recognizable
✅ "Netflix" - Clear and short
❌ "AMZN" - May confuse users
❌ "NFX" - Not recognizable

Next Steps:

Last modified on April 18, 2026

TypeScript Support 2. Use Consistent Formatting