Why It’s Important to Annotate Your Wireframes

by on 09/24/10 at 3:44 pm

Have you ever delivered your wireframes to a client only to have them quickly tell you what things they dislike and want you to change? The problem here is that biases occur when people judge something before they understand it. One cannot objectively judge a design unless they thoroughly understand it. It is likely your client is not well versed in the principles and practices of user experience design. This is why it is your responsibility to communicate your rationale for your design decisions on your wireframes.

Annotating your wireframe elements with clear and concise explanations is important and necessary, so that clients can understand your design before they judge it. If you leave them off, your clients have the power to assert their biased judgement on your design, which can create a breeding ground for subjectivity. To prevent this from happening, it’s important to annotate your wireframes and offer reasons and benefits about why your design is effective. This will give them insight to your thinking process and allow them to think about the things that you think about when you design. Below is an example and four best practices on how to annotate your wireframes.

1. Keep them short and to the point

This is where your writing skills come in handy. Giant blocks of text aren’t attractive to read. Keep your explanations short and to the point. You may have a lot of annotations, which is why keeping them short will make for a faster and easier read. Any further elaboration could be followed up with a meeting if needed. However, clients are usually scarce on time, so I wouldn’t count on it. Get everything you want to say on your wireframe, but keep it concise.

2. Focus on user benefits

Every design decision you make should benefit the user. Thus, your annotations should focus on explaining how each design element helps the client’s users. Focus on the benefits because that’s what clients care about.

3. Use numerical markers and order them

Enumerate your annotations and order them from left-to-right going down the page. This makes it easier to read and will prevent clients from having to jump around the page to read each annotation.

4. Keep them in a column on the right

Keep your annotations on the right next to the wireframe, so that clients won’t have to look too far to read them. It follows the natural left-to-right progression people use when they’re reading.

Annotating your wireframes is an extra step in the process, but it is well worth it. If you truly believe in your design you will go through great lengths to help your clients understand it. It’s hard for clients to look at a wireframe and notice every grain of detail you have put into it. Annotations allow your clients to look at your design without passing judgement. As a designer, your job is to think objectively. Sometimes in order for a project to succeed you will have to help the people you work with think objectively as well.

Why It’s Important to Annotate Your Wireframes

Why It’s Important to Annotate Your Wireframes Why It’s Important to Annotate Your Wireframes

Author and editor-in-chief of UX Movement. Loves great web experiences and fights for the user.

15 Responses to “Why It’s Important to Annotate Your Wireframes”

  1. Daniel

    Sep 24th, 2010

    I agree that it is common practice in desktop applications to have the “action” button on the bottom right corner, does this also apply to websites and forms on the web? from my experience, this buttons are usually on the bottom left side in that case – like the “leave comment” right here.

    • anthony

      Sep 26th, 2010

      That’s not exactly the point of this article, but I hear you. I will be writing another article that talks about the placement of action buttons. Thanks for your input though.

    • Dave

      Mar 12th, 2011

      But completely unlike the “Reply to this comment”.

      I often see single buttons on the left, but when there’s multiple buttons they’re on the right.

  2. Nlecam

    Sep 27th, 2010


    What tool did you use to generate this wireframe ?


  3. Dana Cohen Baron

    Sep 27th, 2010

    I totally agree on the importance annotating wireframes . I usually use callouts (or “balloons”) that point to the UI elements tehmselves, but I think the layout you are proposing (enumeration + column to the right) is much easier to browse and read. Thanks

    • anthony

      Sep 27th, 2010

      Exactly. Call outs are good if you only have a few annotations. But if you have a lot of annotations numerical markers make it neater and more organized because you don’t have a bunch of arrows pointing to things from all directions.

  4. Ben

    Sep 28th, 2010

    I love it, going to copy you immediately and take all the credit for it. :) Great work!

  5. willdonovan

    Sep 28th, 2010

    Great article.

    Your ‘share with twitter’ link at the bottom of the post didn’t include the web link.

  6. ken

    Sep 30th, 2010

    I’ve been vacillating between notations on the right and below. But you make a good case for putting them on the right.

    In Graffle I put annotations on a separate layer so I can turn it off if someone needs a “clean” wireframe.

    • Puja

      Oct 5th, 2011

      Oooh, using a layer for annotation is a great idea. In fact, I never think of using layers in OG, so this is a great reminder.

      Thank you. As someone who is new to wireframing, these tips really help!

  7. Andrew

    Feb 20th, 2011

    “Powerpoint 2007″ can be used to do all of the above too.

  8. Ben McGrath

    Mar 8th, 2011

    Fantastic article. We’re just building this feature into our new wireframing tool http://www.insitui.com. After reading this I’m leaning towards a character limit on notes to assist brevity and communication design. Thanks.

  9. BURKE

    Jun 7th, 2011

    This is a well written article with a clean example. I am currently using this page as a reference for “what a wireframe annotation is” in my interface usability courses. I hope you will keep this page live for some time.

    Thanks, looks good!

  10. joe the red

    Jan 2nd, 2013

    Our UX Manager insists that we put in page notes in a very specific format – it is very time consuming and i know that no one looks at them because the way Axure implements page notes is a click away from the wireframe in prototype mode. I guess I just need reassurance that I’m not crazy here. Is there a use for the rigid system explained below for an in-house UX group? What is the appropriate level of annotation? For context, I prototype everything and demo it to the BAs. They in turn work with developers to communicate requirements during sprint planning. I rarely get a chance to interact with the developers directly, so in my mind, the notes should be an opportunity to do just that. Here is an example of what my manager mandates that we do, with my rants sprinkled in:

    What is this page for in a few words? Not a big deal, except when the wireframe explains itself, then it’s extra, useless work.

    How big is the page? Again, can’t you look at it and see? Isn’t this the kind of thing one decides at the outset of the project? Does it need to be on EVERY page? Don’t answer that, because it doesn’t.

    How do you get to this screen? Fair, but I still think it depends on the screen. I guess my problem is that this system is a one size fits all system. You are supposed to fill out all of these fields for EVERY screen, no matter what. I find myself trying to make up notes, and then getting frustrated – hence this rant.

    This speaks to the interaction(s) on the page. In my mind, this is the crux of notation. What does this page do? What can one expect when clicking the various elements?

    In this section we are to list the privileges that may impact the screen elements – i’m cool with this one – in my mind it is an extension of the previous category.

    In this section he wants us to list out all of the page elements in the order they will be tabbed through. if you add or remove a button, it requires you to tweak this section. I get WHY this needs to be done. but it’s a lame approach. I think that having a rule would be better. Example: start in content area and work top/down and left/right, then hit main nav, then secondary. list exceptions to this rule if applicable.

    List of related documents like the style guide, interaction guide, etc… I have no problem linking to the interaction guide, but he just wants us to list them, he explicitly does not want them linked. This baffles and angers me. Why make people work to find the documents that you want/need them to understand?

Leave a Comment