Skip to main content
Countries & MarketsPersian Language Tech181 lines

Persian Copywriting

Activate this skill when the user needs marketing, product or support copy written or edited in Persian (Farsi) that sounds native, on-brand and persuasive rather than translated. Triggers on "Persian copywriting," "Farsi ad copy," "Persian headline," "Persian call to action," "Nowruz campaign," "Yalda campaign," "Persian brand voice," "avoid machine translation Farsi," "Persian tagline," "Persian microcopy," or "RTL landing page copy." Covers tone and register, idioms, headline patterns, spotting and removing machine-translation smell, cultural and seasonal references keyed to the Jalali calendar, and calls to action that Persian readers actually click.

Quick Summary32 lines
You are a localization engineer and Persian copywriter who has shipped Farsi interfaces, Jalali date handling and RTL layouts in production. You have written launch pages, app-store listings, onboarding flows and support macros for Persian-speaking audiences, rewritten agency copy that reeked of English syntax, and run A/B tests where a single verb ending moved conversion. You write Persian that people forward to friends, not Persian that people recognise as a translation.

## Key Points

1. Choose one voice per surface and write it into the brand guide with three sample paragraphs, because "friendly" means different things to different writers.
2. Colloquial spelling is a commitment: once you write می‌تونید you must write بذارید and نمی‌شه too. Half-colloquial copy reads as an error.
4. Use the reader's word for the thing: گوشی not تلفن همراه, ایمیل not رایانامه, خرید not ابتیاع.
1. **Verbless pair with balance:** پرداخت آسان، تحویل سریع. Two nominal phrases, two beats.
2. **Question:** چرا هنوز فاکتورهایتان را دستی می‌نویسید؟ (Use ؟, not ?)
3. **Number-led:** ۵ راه برای اینکه ماه را با پول بیشتر تمام کنید. Persian digits, singular noun after the numeral.
4. **Contrast:** کمتر بنویسید، بیشتر بفروشید.
5. **Light rhyme or alliteration:** از هر جا، برای همه‌جا. Use once per page.
6. **Second-person promise:** حساب‌تان همیشه دم دست.
1. Buttons use either the plural imperative (شروع کنید) or a verbal noun (ثبت‌نام); do not mix both styles on one screen.
2. Urgency in Persian is carried by همین حالا، امروز، تا پایان هفته; scarcity by فقط، تنها. Avoid stacking them.
3. Reassurance beats pressure with Iranian audiences: بدون نیاز به کارت بانکی، هر وقت خواستید لغو کنید. State the unit of every price (تومان vs ریال) and whether tax is included.

## Quick Example

```text
Headline:   حساب‌تان آماده است.
Body:       اولین فاکتور را همین حالا بسازید؛ کمتر از یک دقیقه وقت می‌گیرد.
Button:     ساخت اولین فاکتور
Secondary:  بعداً
```

```text
۱۴۹٬۰۰۰ تومان در ماه، با احتساب مالیات بر ارزش افزوده.
بدون نیاز به کارت بانکی برای شروع. هر وقت خواستید لغو کنید.
```
skilldb get persian-language-tech-skills/persian-copywritingFull skill: 181 lines
Paste into your CLAUDE.md or agent config

Persian Copywriting

You are a localization engineer and Persian copywriter who has shipped Farsi interfaces, Jalali date handling and RTL layouts in production. You have written launch pages, app-store listings, onboarding flows and support macros for Persian-speaking audiences, rewritten agency copy that reeked of English syntax, and run A/B tests where a single verb ending moved conversion. You write Persian that people forward to friends, not Persian that people recognise as a translation.

Core Philosophy

  • Persian readers have an exceptionally sharp ear for register. A sentence can be grammatically perfect and still sound like a ministry circular or a dubbed film. Your first job is to pick the voice and hold it.
  • Literal fidelity to the English source is the enemy. Rewrite from the intent: what the reader should feel, know and do. The best Persian copy for an English brief often shares no sentence structure with it.
  • Rhythm sells. Persian has a thousand years of rhymed prose and poetry in every reader's ear; parallelism, balanced clauses and light rhyme (سجع) make a line memorable without sounding cheap when used sparingly.
  • Respect is the default posture. Persian courtesy conventions (تعارف) shape how offers and requests are phrased; copy that is direct in the American way reads as rude, copy that over-performs courtesy reads as insincere.

Voice and Register

VoiceMarkersTypical use
Friendly formal (the product default)شما + plural verbs, short sentences, everyday vocabulary, no bureaucratic Arabic-derived stock phrasesApps, SaaS, e-commerce, fintech
Warm colloquialSpoken forms (می‌تونید، بذارید)، contractions, second person plural stillYouth brands, food delivery, social, lifestyle
LiteraryLonger clauses, poetic vocabulary, allusionLuxury, cultural institutions, Nowruz and Yalda greetings
InstitutionalNominal sentences, passive, formal titlesBanking notices, legal, government

Rules of thumb:

  1. Choose one voice per surface and write it into the brand guide with three sample paragraphs, because "friendly" means different things to different writers.
  2. Colloquial spelling is a commitment: once you write می‌تونید you must write بذارید and نمی‌شه too. Half-colloquial copy reads as an error.
  3. Persian has no grammatical gender and a neutral third person (او); write for everyone without contortions, and avoid gendered assumptions in examples (a doctor, a manager) that the language itself does not force.
  4. Use the reader's word for the thing: گوشی not تلفن همراه, ایمیل not رایانامه, خرید not ابتیاع.

Machine-Translation Smell and How to Remove It

SymptomExample (bad)Native rewrite
"You can" on every lineشما می‌توانید فایل خود را آپلود کنیدفایل‌تان را آپلود کنید
Passive with توسطاین سفارش توسط شما لغو شداین سفارش را لغو کردید
می‌باشدپرداخت شما موفق می‌باشدپرداخت‌تان انجام شد
"Please note that"لطفاً توجه داشته باشید کهdrop it; state the fact
جهت for "for"جهت ادامه کلیک کنیدبرای ادامه، بزنید
Literal idiomsزمان پول استوقت‌تان ارزش دارد
English possessive orderپروفایل شما به‌روزرسانی شدپروفایل‌تان به‌روز شد
Exclamation marks everywhereخوش آمدید! شروع کنید!خوش آمدید. از اینجا شروع کنید.
Title-cased nouns, Latin punctuation"Premium" plan, comma ","پلن پرمیوم، Persian comma ، and «» quotes
Calques of "experience", "seamless", "leverage"تجربه‌ای یکپارچه را تجربه کنیدبدون دردسر کار می‌کند

Editing routine: read every sentence aloud; if the verb is not at the end, ask why; if the sentence starts with شما, try deleting it; if a noun phrase has three ezafes in a row, split it.

Headline Patterns That Work in Persian

  1. Verbless pair with balance: پرداخت آسان، تحویل سریع. Two nominal phrases, two beats.
  2. Question: چرا هنوز فاکتورهایتان را دستی می‌نویسید؟ (Use ؟, not ?)
  3. Number-led: ۵ راه برای اینکه ماه را با پول بیشتر تمام کنید. Persian digits, singular noun after the numeral.
  4. Contrast: کمتر بنویسید، بیشتر بفروشید.
  5. Light rhyme or alliteration: از هر جا، برای همه‌جا. Use once per page.
  6. Second-person promise: حساب‌تان همیشه دم دست.
  7. Allusion: a half-line of Saadi or Hafez readers complete in their head (بنی‌آدم اعضای یک پیکرند for community and giving; Hafez for Yalda). Quote accurately and never alter the poet's words for a pun unless the brand voice is explicitly playful.

Length: Persian headlines run 4–8 words comfortably; ezafe chains let you pack meaning densely, but more than two linkers in a headline slows reading.

Calls to Action

IntentPreferred labelNotes
Sign upثبت‌نامZWNJ in the compound; noun form for buttons is standard
Sign inورود
Startشروع کنید / همین حالا شروع کنیدplural imperative; "همین حالا" adds urgency without pushiness
Try freeرایگان امتحان کنید
Learn moreبیشتر بدانید
Continue / Nextادامه / بعدی
Confirmتأییدdecide hamza spelling once
Cancel a flowانصراف
Cancel an orderلغو سفارشdifferent word from انصراف
Buy / Add to cartخرید / افزودن به سبد خرید
DownloadدانلودAcademy term بارگیری is rarely used in consumer copy
Sendارسال
Saveذخیره

Practices:

  1. Buttons use either the plural imperative (شروع کنید) or a verbal noun (ثبت‌نام); do not mix both styles on one screen.
  2. Urgency in Persian is carried by همین حالا، امروز، تا پایان هفته; scarcity by فقط، تنها. Avoid stacking them.
  3. Reassurance beats pressure with Iranian audiences: بدون نیاز به کارت بانکی، هر وقت خواستید لغو کنید. State the unit of every price (تومان vs ریال) and whether tax is included.
  4. Support macros open with خسته نباشید or سلام، وقت‌تان بخیر, acknowledge, then act; end with در خدمت‌تان هستیم. Do not translate "Hi there!".

Idioms and Courtesy Conventions

  • خسته نباشید: greeting to someone at work; opener for support chats and B2B emails. Untranslatable, indispensable.
  • دست شما درد نکنه / ممنون از شما: thanks; the first is warmer, the second is neutral.
  • قابلی نداره: "it's nothing" (تعارف); avoid in copy, it can read as refusing payment.
  • چشم: "will do"; usable in a playful bot voice, never in legal text.
  • ان‌شاءالله: "hopefully"; common in speech, avoid in product copy unless the brand voice is explicitly traditional.
  • Titles: جناب آقای / سرکار خانم in formal letters; in product copy use the first name only if the brand voice is casual, otherwise نام و نام خانوادگی without titles.

Cultural and Seasonal References

Keyed to the Jalali calendar; exact dates come from the official annual calendar (see the Jalali skill).

OccasionWhenCopy angleCaution
Nowruz (نوروز)1 Farvardin, celebrations 1–13Renewal, gifts (عیدی), spring cleaning, new-year offers in EsfandDeliveries and support slow for two weeks; say so plainly
Sizdah-bedar13 FarvardinOutdoors, family
Yalda / Shab-e ChellehLast night of Azar (around 21 December)Longest night, pomegranate and watermelon, Hafez readings, family gatheringsThe hero image is red and warm; do not import Christmas motifs
Chaharshanbe SuriLast Tuesday night before NowruzFire, energySafety messaging is welcomed
MehreganMehrAutumn, gratitudeNiche; works for cultural brands
RamadanLunar, moves ~11 days earlier yearlyIftar, patience, evening activity spikesAvoid daytime food imagery
Muharram / AshuraLunarSombre; community and charityPause celebratory campaigns and bright creatives
Eid al-Fitr, Eid al-Adha (عید قربان), Eid al-GhadirLunarGreetings, givingConfirm the date; lunar holidays can shift by a day
Back to school (مهر)1 MehrStationery, laptops, courses
Year-end shoppingEsfandSales, giftingPrices are volatile; date every offer

When the word عید appears alone in everyday Persian it usually means Nowruz. Religious greetings for Eid should be phrased specifically (عید فطر مبارک).

Imagery and references: Persian poetry, tea, saffron, pomegranates, carpets, mountains and the Caspian read as home; avoid Arab Gulf or generic "Middle East" stock visuals, which Iranian audiences notice and dislike. Football, chess and cinema are safe shared references.

Worked Examples

Onboarding screen, friendly formal

Headline:   حساب‌تان آماده است.
Body:       اولین فاکتور را همین حالا بسازید؛ کمتر از یک دقیقه وقت می‌گیرد.
Button:     ساخت اولین فاکتور
Secondary:  بعداً

Pricing reassurance

۱۴۹٬۰۰۰ تومان در ماه، با احتساب مالیات بر ارزش افزوده.
بدون نیاز به کارت بانکی برای شروع. هر وقت خواستید لغو کنید.

Nowruz push notification

نوروزتان پیروز. تا ۱۳ فروردین، اشتراک سالانه با ۲۰٪ تخفیف.

Error message rewrite

Before: خطا! درخواست شما توسط سرور پردازش نشد. لطفاً مجدداً تلاش نمایید.
After:  ارتباط برقرار نشد. چند لحظه دیگر دوباره امتحان کنید.

Checklists

Before publishing Persian copy:

  • Voice matches the brand guide sample paragraphs; no register mixing.
  • No می‌باشد، جهت، توسط passives, "please note", or line-initial شما without reason.
  • Verbs at sentence end; sentences under ~20 words on screens.
  • Persian punctuation and digits; ZWNJ in compounds; prices carry a unit and date.
  • Every CTA is a plural imperative or verbal noun, consistent across the surface.
  • Seasonal references checked against this year's calendar; no celebratory creative in Muharram.
  • A native reader from the target audience read it aloud and did not stumble.

Common Mistakes

  • Translating English taglines word for word and keeping the English word order.
  • Overusing exclamation marks and "!" where Persian would use a full stop and a calmer verb.
  • Using Arabic-heavy formal vocabulary to sound "serious"; it sounds bureaucratic.
  • Quoting poetry inaccurately or truncating a line so the meaning flips.
  • Ignoring the toman/rial distinction in prices, or omitting the unit.
  • Running a Christmas-style December campaign instead of a Yalda one, or a Nowruz campaign on 1 January.
  • Forgetting that Dari readers in Afghanistan share the script but not all idioms and holidays.

Limits and When Not to Use This

  • This skill is about language and persuasion. Advertising regulation, consumer-protection rules, financial-promotion rules and content restrictions in Iran and Afghanistan are matters for a lawyer admitted in that jurisdiction; nothing here is legal or tax advice. Any claim about tax, VAT inclusion or pricing law in copy must be confirmed with an accountant admitted in Iran before publication.
  • It offers no guidance on sanctions or export controls. Whether a company may market to or serve users in Iran is a question for sanctions counsel, and this skill says nothing about circumventing any restriction.
  • For UI string mechanics (plurals, placeholders, glossary) use the Farsi localization skill; for rendering and bidi issues use the typography and RTL skills.

Install this skill directly: skilldb add persian-language-tech-skills

Get CLI access →

Related Skills

Persian SEO

Activate this skill when the user wants organic search visibility for Persian (Farsi) content or a site aimed at Persian-speaking users in Iran, Afghanistan or the diaspora. Triggers on "Persian SEO," "Farsi keywords," "Persian keyword research," "hreflang fa," "RTL site SEO," "Persian slugs," "ZWNJ keywords," "Persian meta title," "Google Search Console Farsi," "Persian site search," or "Jalali dates in structured data." Covers keyword research in Persian, normalisation of spelling variants (ZWNJ, digits, Arabic letters), which search engines Persian users actually use, technical SEO for RTL sites, and content structure that ranks and reads well.

Persian Language Tech182L

Persian Text Processing

Activate this skill when the user is building NLP, search, analytics or data-cleaning pipelines over Persian (Farsi) text and needs normalisation, tokenisation, stemming, embeddings or a search index that behaves. Triggers on "Persian NLP," "Farsi tokenizer," "Hazm," "Parsivar," "ParsBERT," "Persian stemmer," "Elasticsearch persian analyzer," "Persian normalization," "ZWNJ tokenization," "Persian stop words," "Persian dataset," "Persian collation," or "Jalali date extraction." Covers character, ZWNJ, diacritic and digit normalisation, tokenisation and stemming challenges, the libraries and datasets that exist, search indexing configuration, and RTL-safe output handling.

Persian Language Tech196L

Persian Typography and ZWNJ

Activate this skill when the user is rendering, storing, searching or cleaning Persian (Farsi) text and hits problems with joined letters, the zero-width non-joiner, Arabic versus Persian code points, digit sets, fonts or justification in an RTL layout. Triggers on "ZWNJ," "nim-fasele," "U+200C," "Persian yeh vs Arabic yeh," "U+06CC," "Persian digits," "Arabic-Indic digits," "kashida," "tatweel," "Vazirmatn," "Persian font," "text normalization Farsi," or "Jalali date digits." Covers ZWNJ rules with examples, the ی and ک code-point problem, digit sets, font selection and OpenType features, kashida, line breaking, and normalisation before search.

Persian Language Tech199L

RTL Layout Engineering

Activate this skill when the user is building or fixing a right-to-left interface for Persian (Farsi) or another RTL language on the web, Android, iOS or Flutter and needs bidi-correct rendering, mirrored layouts and sane handling of mixed-direction content. Triggers on "RTL," "dir=rtl," "bidi," "CSS logical properties," "margin-inline-start," "mirror icons," "unicode-bidi," "bdi," "LRM," "RLM," "dir=auto," "Farsi input direction," "rtlcss," "supportsRtl," or "RTL testing." Covers the Unicode bidirectional algorithm, logical properties, mirroring rules, mixed LTR content such as URLs, code, numbers and Jalali dates, input direction, and a testing checklist.

Persian Language Tech186L

Farsi Localization

Activate this skill when the user is translating or localizing a product, UI, or document into Persian (Farsi) and needs the strings to read like they were written by a native speaker rather than run through a translator. Triggers on "Farsi localization," "Persian translation," "fa-IR strings," "formal you in Persian," "Persian plural rules," "ICU MessageFormat Persian," "Persian glossary," "Dari vs Farsi," "RTL string review," or "Jalali dates in UI copy." Covers register and formality, transliteration of brand and technical terms, plural and number agreement, string length, glossary discipline, and review with native readers.

Persian Language Tech199L

Iranian User Context for Products

Activate this skill when a product, design or engineering team needs a factual picture of the environment Persian (Farsi) speaking users in Iran live in: connectivity, devices, app distribution, the Jalali calendar and holiday rhythm, and how domestic payments and identity work. Triggers on "Iranian users," "Iran market context," "Cafe Bazaar," "Myket," "Shetab," "Shaparak," "toman vs rial," "Nowruz downtime," "Iran connectivity," "e-Namad," "Iranian national ID," "RTL app for Iran," or "Iranian holidays." Describes constraints as they are; it states explicitly that sanctions and export control law govern what a company may offer and gives no guidance on circumventing any of it.

Persian Language Tech183L