How to write a handwritten note for customers

To write a handwritten note for customers, keep it short, use their name, mention one thing specific to them, write the way you talk, and sign it from a real person. That is most of it. The rest is knowing what fits on a card and what a pen can actually write.

Keep it short

A notecardHQ note can be up to 500 characters. That is a ceiling, not a target. Our cards are 7x5 inches, and handwriting takes more room than type. A few sentences in comfortable handwriting look like a note. A full card of small handwriting looks like a letter, and it asks more of the reader.

Three or four sentences is plenty for most notes: who it is for, why you are writing, one specific detail, and a sign-off. If you are over that, cut the sentence that could appear on any customer's card.

Make it about them

The difference between a note and a mailing is one specific detail. Use their first name. Then mention something only they would recognize: what they ordered, how long they have been a customer, something they told your team, or the milestone that triggered the card. One detail is enough. Pile on more and it starts to feel like you are reading them their file.

If you send from code, the API writes your content exactly as sent, so fill in the details in your code before the request. Check for empty or odd values. "Hi ," and "Hi FIRSTNAME" are written exactly as sent too.

Write the way you talk

Read your note out loud. If it sounds like a press release, rewrite it. Skip phrases like "valued customer," "we appreciate your business," and "don't hesitate to reach out." Say what you would say if you handed them the card in person.

Avoid selling in a thank you note. A card that says thank you and then pitches an upgrade turns the thank you into a setup. If you want to include something useful, like a direct email address for questions, that is fine. Keep it to one line.

Here is a short note that works:

Maya, thank you for your first order. I packed it myself and hope the blue one was the right call. If anything is off, email me at sam@example.com. Sam

It is short, it names one real detail, it offers a way to reply, and it is signed by a person.

Sign it from a person

Sign with a first name, or a first name and a role, like "Sam, founder" or "Priya and the support team." A note signed by a company name alone reads like it came from no one. If more than one person sends cards, let each signature match the person the customer actually deals with.

Simple closings work best: "Thanks again," "Talk soon," "Cheers." You can also skip the closing and end with the name.

What a pen can write

The note is written by a robot holding a real pen, so every character has to be something a pen can draw. You can use:

• Letters and digits
• Punctuation: . , ! ? ' " - : ; ( )
• Symbols: / @ $ & # % + =

Characters the handwriting model cannot write natively, like @, $, &, and %, are drawn as single-stroke glyphs, so they come out clean and in the same pen. You do not need to spell anything special out. Write 20%, Q&A, or #3 the way you normally would.

Leave out emoji, because a pen cannot draw them. Leave out long dashes: use a comma, a period, a colon, or a plain hyphen instead. Leave out currency signs other than $. Word processors and writing tools often swap in characters that look similar to the ones above, so check copy in a plain text editor, or clean it in code, before you send.

Numbers get extra care in the studio. Before writing, every word is read back by OCR, and digits must read exactly or they are redrawn. An order number or a phone number in your note will be checked. See how we check every card for the full process.

Match the note to the moment

A first order, a renewal, and a save after a rough month each deserve different words. Write one note per milestone instead of one note for everything. A first-order note says welcome. A renewal note says thank you for staying. An anniversary note can mention the date they started. The guide to when to send handwritten cards covers which moments are worth a card and how to trigger each one.

Mail takes time, so write words that still make sense when the card arrives. Thank them for something that already happened, not for something that is about to.

Test the copy before you scale it

Copy that reads well on a screen can look different on a card. A sentence that seemed short might fill more of the card than you expected. A name might look different in handwriting than you pictured. The only way to know is to see it written.

Build your integration with a test key, which never writes or mails anything. Then, before going live, send one real note to yourself with your live key, using your real copy and your real design from the card studio. Read it the way your customer will, at the kitchen counter, with no context. If anything feels long or generic, fix it and send another.

When you are ready to automate, the handwritten notes API guide covers the request, idempotency keys, and statuses.

The content field and its limits are documented in the notecardHQ API docs.