Documentation

Complete guide to using Shabdly for e-commerce translation

Getting Started

Welcome to Shabdly! This guide will help you translate your e-commerce product listings into Indian regional languages quickly and efficiently.

Step 1: Sign Up

Create a free account and get 1,000 free word credits to start translating immediately.

  • No credit card required
  • Instant access to dashboard
  • Free words never expire

Step 2: Prepare Your File

Shabdly accepts CSV and Excel files. Your file should have columns for:

  • Product Title - The name of your product
  • Product Description - Detailed description with HTML tags (optional)
  • Bullet Points - Key features (can use HTML lists)

💡 Tip: HTML tags like <b>, <li>, <br> are preserved! Your translations will be copy-paste ready for Amazon/Flipkart.

Step 3: Upload & Translate

  1. Upload your CSV/Excel file
  2. Select target languages (Hindi, Tamil, Telugu, etc.)
  3. Choose a tone preset (Formal, Bargain, Youth)
  4. Click "Start Translation"
  5. Download results in 2-5 minutes

File Upload Guide

Supported File Formats

  • CSV (.csv) - Standard comma-separated values
  • Excel (.xlsx) - Microsoft Excel format

File Size Limits

Plan Max Products Max File Size
Free 100 products 5 MB
Starter 500 products 10 MB
Growth 2,000 products 20 MB
Scale 10,000 products 50 MB

Sample File Structure

product_title,product_description,bullet_points
"SwiftCook Pressure Cooker 5L","High-quality <b>stainless steel</b> pressure cooker","<li>5-liter capacity</li><li>BIS certified</li>"
"SmartPhone X-500","Latest 5G smartphone with 128GB storage","<li>6.5-inch display</li><li>48MP camera</li>"
                                

Supported Languages

Most Popular

  • Hindi (हिन्दी) - 600M+ speakers
  • Tamil (தமிழ்) - 75M+ speakers
  • Telugu (తెలుగు) - 80M+ speakers
  • Kannada (ಕನ್ನಡ) - 45M+ speakers

All Languages

  • Bengali (বাংলা)
  • Marathi (मराठी)
  • Gujarati (ગુજરાતી)
  • Malayalam (മലയാളം)
  • Punjabi (ਪੰਜਾਬੀ)
  • Odia (ଓଡ଼ିଆ)
  • Assamese (অসমীয়া)
  • Urdu (اردو)

💡 Pro Tip: Start with Hindi for the largest market reach (600M+ speakers). Then expand to regional languages based on your target states.

Brand Glossary

Protect your brand names, model numbers, and SKUs from translation using the Brand Glossary feature.

How It Works

  1. Go to Dashboard → Brand Glossary
  2. Add terms you want to protect (e.g., "SwiftCook", "X-500")
  3. These terms will remain unchanged in all translations

What to Add to Glossary

  • Brand names (e.g., "SwiftCook", "TechPro")
  • Model numbers (e.g., "X-500", "Pro-2024")
  • SKUs and product codes
  • Technical certifications (e.g., "BIS Certified", "CE Marked")
  • Trademark symbols (™, ®)

✅ Example:
Without Glossary: "SwiftCook Pressure Cooker" → "स्विफ्टकुक प्रेशर कुकर"
With Glossary: "SwiftCook Pressure Cooker" → "SwiftCook प्रेशर कुकर" ✓

Pricing & Credits

Shabdly uses a word-credit system. You pay only for words translated.

How Credits Work

  • 1 credit = 1 word translated
  • Example: 100-word product description to 3 languages = 300 credits
  • Credits never expire
  • Buy more credits anytime

Word Counting

We count English words in your source text. Here's what counts:

  • Counted: Product titles, descriptions, bullet points
  • Not Counted: HTML tags (<b>, <li>), brand names in glossary

💡 Cost Example:
- 500 products × 50 words average × 3 languages = 75,000 credits
- Growth Plan (100,000 credits for $49) = $0.00065 per word
- Total cost: $49 for 500 products in 3 languages

API Reference

Scale plan only: Integrate Shabdly directly into your workflow with our RESTful API.

Authentication

POST /api/auth/login
Headers: Content-Type: application/json
Body: { "email": "user@example.com", "password": "your_password" }
Response: { "token": "jwt_token_here" }
                                

Upload Translation Job

POST /api/translations/upload
Headers: 
  Authorization: Bearer {token}
  Content-Type: multipart/form-data
Body:
  file: [your_csv_file]
  targetLanguages: ["hindi", "tamil", "telugu"]
  tonePreset: "formal"
Response: { "jobId": "job_123", "status": "processing" }
                                

Check Job Status

GET /api/translations/jobs/{jobId}
Headers: Authorization: Bearer {token}
Response: { "status": "completed", "downloadUrl": "..." }
                                

Rate Limits

  • Scale Plan: 1000 requests/hour
  • Enterprise: Unlimited (contact us)