2

As the title question asks:

Should embedded figures/images be placed before or after they are referred to in text?

Which is more appropriate? Or does it depend on the setting/context?

  • Highly related: writers.stackexchange.com/q/8164/1993 – Monica Cellio Jan 8 '15 at 15:18
  • @MonicaCellio Not just "highly related" IMHO but a flat-out duplicate. I don't want to flag it as such because 1) it has lots of views and helpful answers and 2) a mod, you, already noticed this and did nothing. So I wonder, do we just leave it cause it's old? Or merge them? Or close this one as a dup (so it's still visible)? – Cyn Feb 25 at 4:07
  • @Cyn the other one is more specific, asking specifically about end-user documentation and screenshots. It's possible that the considerations are different in, say, scientific journal articles with diagrams or equations. – Monica Cellio Feb 25 at 4:42
4

This depends in part on the type of writing (technical reference manual? novel with illustrations? etc) and how people will read it (printed book? online?).

If a reader follows a reasonable path1 through the document, there should never be a point where he's looking at something incomprehensible. This applies to text, code samples, diagrams, and screen shots. Therefore, unless the structure of your document itself provides this (e.g. through section titles and a consistent format, like in a catalogue), you should always have some explanatory text before the screen shot to provide context.

However, this principle applies to text too -- you don't want to have a page of text describing stuff that will only make sense after someone sees the image, either. So in my experience the norm is: text that sets the stage, then the image, then details that refer to the screen shot.

This is true with or without figure numbers and captions.

Contrary to this answer, I do not recommend placing an image in the middle of a sentence ("in this figure: (figure) we see..."). I've found that for many readers the image functions as its own "paragraph", and they find the dangling sentence fragments around it distracting. I'll do this in casual writing like on my blog, but I try to avoid it in formal writing like documentation or books.

All of this is for images where some textual explanation is needed. If you're writing a novel and are including maps or illustrations purely as supplementary material, then you can put those wherever you want as the text does not depend on them and they do not depend on the text.

1 At minimum (for non-reference doc), starting at the beginning and reading through. But also consider the case of someone who looks something up in the table of contents and jumps there, and, if applicable, the use of your documentation in online context-sensitive help.

  • So, the essentially principle is to avoid the reader having to back-track while reading, yes? Thanks! – XYZT Jan 8 '15 at 20:21
  • @NikhilMahajan that's a good way to put it, yes. If the reader ever has a "wait, what?" moment because of the order you presented things in, see if you can fix that. (Well, unless you're deliberately doing that to prompt a teaching moment, but that's probably not common.) – Monica Cellio Jan 8 '15 at 20:50
4

In printed books or journals, figures and tables are placed on the same double page as the first reference. Where exactly they are placed depends on how their placement affects page breaks. Typesetters try to avoid ugly "widows" and "orphans", that is, one or two lines broken from a paragraph and pushed to the next page.

If page layout and logical text structure are not affected, place a table or figure immediately after the first reference to it:

... as Figure 1 shows:

enter image description here

Bla bla ...

For placement, think about when you would show and point at an illustration when speaking to someone. Usually you show the image while you refer to it, verbally. So place the image in your text in a way that mimics that deictic behavior. Colons are an ideal approximation.

If it cannot be placed immediately after that first reference, place it after the paragraph containing the first reference.

If that, too, is not possible, place it

  • on the same page, or
  • the same double page, or
  • on the following page or double page, or
  • the preceding page or double page,

in that order of preference.

If you submit an article to a journal, follow their style guide. Usually you must write "Figure 1" in the center of an empty line, sometimes in brackets, spaced with an empty line above and below, and place the figure in an appendix:

... as Figure 1 shows:

                                                                        [Figure 1]

Bla bla ...

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.