Click here to Skip to main content
13,053,891 members (57,406 online)
Click here to Skip to main content
Add your own
alternative version


9 bookmarked
Posted 16 Oct 2007

Text Modules in Software Support

, 16 Oct 2007
Rate this:
Please Sign up or sign in to vote.
Make your software support work easier by using text modules


They have many names. The dictionary calls them boilerplate text, but you'll also find them as stationery, AutoText, templates, canned text or text macros. The idea is always the same: type a text once-use it many times. This article is about why they are useful for software support and how to get the most out of them.

Why Use Text Modules?

Customers are asking questions. And chances are that they'll ask you the same questions over and over again (probably ignoring any FAQ). And you're typing the same answers again and again. You don't? Sure? Test it! For the next twenty answered mails, pause for a second and think if you didn't write that answer (complete or in parts) before. You'll see that it happens more often than you thought. Still, you probably refrain from storing these texts in some form, because of the extra work this causes. Organizing the texts, choosing a wording that can easily be reused later for another customer, etc. But this work quickly pays off; you just have to start it. And the more text modules you have ready, the more time you can save, you'll see.

As a side-effect, you'll probably also deliver the answers to customers quicker than you used to. Since canned text makes answering e-mail easier, you're less likely to procrastinate the answers.

Text modules have another advantage. Customers sometimes are unfriendly or simply write stupid things. It's tempting to let your feeling go wild and write a hefty response. That may be satisfying for the moment, but it will definitely backfire. Trust me, I already made that mistake. If you have a text module to handle the customer's issue (written in a friendly tone) it's much easier to give the customer a professional reply.

Furthermore, a text module library makes it easier for other persons to do your support work either while you're on holiday or if you permanently give the support job to somebody else. This way they have to know less about your products and your company policies because they can just use pre-written texts.

Creating and using your text modules forces you to organize and categorize your support cases. This will also make it easier for you to see what the typical questions are that the people keep asking. That's very valuable knowledge. Perhaps you can change your product or website to make these issues clearer even before the customer has to write you an e-mail?

Advanced Issues

If the text modules really become useful for you and your collection grows, you'll face a different problem. Finding a text you've written months ago. That's why you have to organize and maintain your texts. Giving the texts short headlines is essential and folders are very handy, too.

If you do support in multiple languages, you'll probably want to use the same text in these languages, too. This can be difficult with most text module products, as they don't support it. As a workaround you can use folders or prefixes (or postfixes) with the language name in the headline (like "EN - Install problem"). But it's important to use the same headline for the same issue, no matter what language the response is in. Otherwise you'll constantly look for the wrong text. (Another mistake that I already made.)

The English language isn't very picky when it comes to addressing a person, but other languages offer more choices than simply "you". Depending on your language and communication policies you may even want to store the same text in different styles: formal and informal. Otherwise you might easily end up with addressing somebody with his last name in the greeting phrase and using an informal addressing ("tu" in Spanish, for example) in the text module. Sometimes texts are basically the same for several products or vary in other minor issues. So it makes sense to use one single text modules here and just fill in the gap when you're inserting the text.

Some text modules programs can ask for the gap text. If yours doesn't, simply use a placeholder like ######. The hash marks are great because you can very easily see them and it's less likely that you send out a mail where you didn't fill in the gap.

Choosing the Right Product

Did I catch you? Great, here are a few things you should consider when choosing the right text modules software for you.

  1. Subfolders (Multiple levels)
    These are absolutely essential if you want to stay organized
  2. General or integrated
    If you plan to use text modules only in your e-mails, you might want to look for a product that can be integrated into your mail client, making the texts easier to access. If you want to use it in other places, too (software development perhaps?), you should use a program than can cooperate with all applications on your PC.
  3. Multi-Language
    If you speak more than one language and answer support mails in the other language(s) you'll find it useful to have your text modules in multiple languages.
  4. Multi-User
    If your company is not a one-man-show, you'll probably want to share your canned text with other persons. You could probably just copy the configuration files around, but it would be easier if the program supports a multi-user environment from the start.
  5. Icons
    You'll probably look down on this point. But I've found it very useful because it's easier to memorize an image than a text.

Good luck with your text modules!

[Thomas Holz is the owner of, a company offering the "Easy2Sync" file- and Outlook synchronization tools as well as the boilerplate software for Outlook "ReplyButler".]


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Germany Germany
No Biography provided

You may also be interested in...


Comments and Discussions

-- There are no messages in this forum --
Permalink | Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.170713.1 | Last Updated 16 Oct 2007
Article Copyright 2007 by ITSTH
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid