Gwen Hernandez

Author of romantic suspense. Scrivener expert.

Tech Tuesday: Inserting Images in Scrivener

I’ve been getting a lot of questions about using images in Scrivener lately, especially from those interested in producing e-books. There are several ways to handle images in Scrivener, and I’ll provide a run down of the basics here.

These options work in both Mac and Windows.

  • Copy the image from somewhere and paste it into the text.
  • Go to Edit–>Insert–>Image From File…
  • Import the image into the Binder (outside the Manuscript/Draft folder) and drag it into the desired document.
  • Go to Edit–>Insert–>Image Linked to File…

The last option is closest to using an image tag with an external file (Mac only for now, discussed below) because it doesn’t insert the actual image into your project (thus keeping your project file size down). Instead, it shows a placeholder image (a cached version of the original) that is linked to the image file. When you compile, the linked file will be inserted into the compiled output. This is handy if you don’t yet have print quality versions of artwork, but want to include a placeholder in your text. Just save the print-ready image to the same name/location as the original linked file and Scrivener will use your quality images.

Images in Scrivener are added inline, so they’re treated like a character as far as word-wrapping goes. Which means that text does not wrap around the image. To resize an image, right-click and choose Edit Image (Windows) or Scale Image (Mac).

NOTE: To avoid image display problems when compiling to EPUB or MOBI, make sure your image name doesn’t contain special characters (e.g. # + @ * !).

Working with Image Tags (Mac only, for now)

Inserting an Image into the Text

If you have quite a few images you want to use within your manuscript, there’s no need to insert them into the text directly. Instead, you can use the IMG tag to refer to the desired image in the Binder or on a drive you have access to.

Also, because image tags are text based, they give you additional capabilities: the flexibility to insert images into places where they can’t normally go, and the ability to search for images by image name or the image tag.

Here’s how to insert an image with an image tag.

1. Import the desired image into your project (or see NOTE below for using external image files).

An easy way to import is to right-click (or control+click) the folder where you want to store the image (must be outside of the Manuscript/Draft folder) and choose Add—>Existing Files. Then choose the desired image file.

2. Select the desired document, and click within the editor in the exact location where you’d like to insert the image.

3. Type <$img:ImageName> (where ImageName is the name of the image as it appears in the Binder).

TIP: To designate the size of the image, you can enter either its height or width and the image will adjust the other measurement accordingly. You can also enter both dimensions, if desired. Do so in the following manner:

<$img:ImageName;w=100> to assign a width of 100 pixels

<$img:ImageName;h=80> to assign a height of 80 pixels

<$img:ImageName;w=100;h=80> to assign both measurements


4. I suggest adding a blank line above and below the image for spacing.

The image will appear in the text with the same indents and format as the text. To give it different formatting, such as centering or full left alignment, adjust the format, select the image, then go to Format—>Formatting—>Preserve Formatting. The image will have a blue tint and a dashed line around it. This will prevent the standard compile settings from being applied to the image.


NOTE: If you have a lot of images to include and don’t want to bloat your project, you can also use the image tag to reference files that are not imported to your project. You just need to know the file path. For example, the following IMG tag points to a file on my hard drive and resizes it to 100 pixels in height. If you center it and preserve the formatting, the picture will be centered. Just make sure not to move the original image without modifying the file path in the IMG tag.

<$img:/Users/Evergreen/Pictures/BernSuisse1980.jpg; h=100>

For a good primer on how to copy a file’s path on a Mac, check out:

Using an Image at the Start of Each Chapter

You can set up Compile to insert an image either before or after the title of each chapter. Below are the steps for inserting it below the chapter auto-number.

1. Import the image as outlined in Step 1 of the previous section.

2. Open the Compile window (File—>Compile), and make sure that the All Options button is selected at the top.

3. Select the Formatting tab on the left.

4. Select the folder Level 1+ row at the top of the table (this assumes a standard set up of chapter folders and text documents for scenes).

5. If you plan to use chapter auto-numbering instead of folder titles, be sure to deselect the Title checkbox.

Find more on this in the post on Compiling.

6. Click the Section Layout button at the top of the small Editor pane.

7. The Prefix text box is where the auto-numbering placeholder goes, as shown in the example. In the Suffix text box, type: <$img:ImageName>. (If you want more space after the image, you may insert one or more Return characters).

If desired, add a height or width dimension, as mentioned in Step 3 of the previous section.


8. Click OK. Then, when all other settings are as desired, click Compile.

To have the image appear before the title or auto-number, put the image tag in the Prefix text box, and the auto-number tag (if using) into the Suffix text box.


Using an Image as a Scene Separator

If you’d like an image to appear between each scene, you can add an image tag as a Custom separator in the Compile window.

1. Import the image as outlined in Step 1 of the Inserting an Image into the Text section above.

2. Open the Compile window (File—>Compile), and make sure that the All Options button is selected at the top.

3. Select the Separators tab on the left.

4. In the Text Separator drop-down menu, choose Custom.

5. In the Text Separator text box, type: <$img:ImageName>. Unless your image is already small, I suggest adding a height or width adjustment as outlined in Step 3 of the Inserting an Image into the Text section above.


6. When all other settings are as desired, click Compile.


Using an Image as an End-of-Text Marker

Want to mark the end of your manuscript with a special image? The process is similar to those outlined above. NOTE: This only works with Print, PDF, and text-type output, not e-books.

1. Import the image as outlined in Step 1 of the Inserting an Image into the Text section above.

2. Open the Compile window (File—>Compile), and make sure that the All Options button is selected at the top.

3. Select the Layout tab at the left.

4. Select Mark End of Text With checkbox.

5. In the Mark End of Text With text box, type <$img:ImageName>.


6. When all other settings are as desired, click Compile.


I’ve been asked about inserting images into headers and footers, but headers and footers in Scrivener do not support the IMG tag at this time.

Got more Scrivener questions? Check out my online classes, or my book Scrivener For Dummies.

Good luck!

[Updated 10/16/14]


  1. Thanks for this, I have been looking everywhere for this info! However when I comple it still just shows and no images.

    • amcateesd: Glad to help! If you’re using Windows, the img tag isn’t supported yet. If you’re using Mac, make sure you remember the $ sign. That’s where I usually go wrong. :-)

  2. Great post. Really useful.

  3. Nice post, Gwen! Very informative on how to use those placeholder tags for inserting images. I will be using them to “spruce up” my chapter titles and scene divisions. Thanks…Mark

  4. Hi Gwen, thanks for the post. I have been waiting for someone to address this issue. I am writing a book on the history of my parent’s home and the surrounding area so it is going to be photo intensive (not sure if this makes Scrivener the less than ideal choice but I have liked it so far). I am using the Windows version of Scrivener so my options are pretty limited right now in terms of how I insert my images. Are there any tips/guidelines you can offer in terms of what size to make the images that are inserted? I plan on making an ebook but also a print version with the help of the local historical society. Its obviously pretty easy to re-size them so that they look good within Scrivener but I don’t expect that to translate to the outputted format. Thanks for any input!

    • Steve: If you’re going to have a lot of images, I wouldn’t import them and then insert them, I’d just insert them where you want them and leave the originals on your hard drive. This should help keep the overall project size down. You also might want to resize them down to about 300 dpi before you insert them so that they don’t bog down your project too much. I’m not sure if resizing the image once it’s embedded in your Scrivener document will change the amount of MB the image adds to your project.

      It’s my experience that whatever size they are in relation to the text holds when you create the e-pub. At least it did when I looked at a test. You can use Adobe Digital Editions (free) to view an epub file and how the format will appear on most non-Kindle readers. You can view Kindle MOBI files on Amazon’s Kindle Previewer (free and available at That way you can check on multiple types of devices what the images will look like.

      I’d suggest keeping an eye out for future updates to the Windows version, because when the img tag finally makes it into Windows, you should be able to use a file path outside of Scrivener so you don’t have to import the photos into your project at all if you don’t want to.

      Good luck!

  5. Thanks so much for the response Gwen. You answered questions I didn’t even ask :)

  6. Hi Gwen–I heard your interview on the Self Publishing Podcast and found your site. This article and the whole site are both really awesome and quite helpful.

    Just wondering if there’s a trick to get the text to wrap around an image. I’ve tried align=left included inside the but the text starts on a line even with the bottom corner of the image rather than the top. Am I missing something obvious?

    Thanks again!

    • Baker: Thanks for letting me know how you found me. Glad you’re finding the site helpful! :-)

      Unfortunately, there’s no text wrapping in Scrivener. All images are inline only, which means they’re treated as a text character from an alignment standpoint. So, you’re not missing anything, it just doesn’t do it. For ebooks, inline is probably what you want anyway. Just put the image on its own line. For other output types, you’ll need to use a word processor or layout program to set up word wrapping.

  7. Thank you so much for this post! It has helped me immensely!

    I am using a scene spacer between scenes, and I have followed your tips to include a space above and below the image, and I highlighted the tag and centered it, and checked “preserve formatting”. However, when I compile it, the image is STILL flushed to the left. Is there anything I can write directly in the code of the tag to keep it centered?

    • Crispin: There are no additional qualifiers that you can put inside the tag other than height and width.

      Does your tag have the blue highlight with a dashed line around it, identifying it as preserved formatting? If not, try applying preserve formatting again.

      Another option would be to paste the image itself (or import and the drag from the Binder to the desired spot), rather than using a tag. I found that when I inserted the image and centered it, I didn’t need to use Preserve Formatting to keep it centered like I did with the img tag.

      Also, if you divide your scenes into separate documents, you can use the Separators tab for the image tag instead (using a Custom separator as described in the post), which will ensure they’re always centered.

      I hope that helps.

  8. Hmmm, I am trying to avoid the scene separator option for the time being (I am looking at it as a last resort, but there would be a lot of extra footwork involved in the getting the document divided up)

    I’ve used both the image tag placeholder, and dragging and dropping the image onto the page, as methods for bringing in the image. And the image shows up well on the Previewer and mobile devices… it just flushes left despite all of my endeavors. I’ll select it and then choose “preserve formatting” from the formatting menu, as well as opening up the options pane under compile>formatting and making sure the boxes for alignment are checked in that area as well.

    Looks like I’ll have to make a strong cup of tea and keep working at it. Thanks for the advice! I know it has to be something as simple as another box that needs to be checked/unchecked ;)

  9. Hi Gwen – I’ve added a few photos in the way suggested (I’m using the Windows version) and I’m finding that Scrivener is lagging horribly, sometimes for 15-20 seconds or more (sometimes getting the not responding message at the top). This is making Scrivener nearly unusable for my purposes. I’m not sure if it’s something that I am doing wrong or not but it’s quite frustrating. I’m not using the world’s fastest computer but I run programs such as Photoshop and Lightroom all the time without too much difficulty. I’m just wondering if Scrivener isn’t the right program for what I’m doing. I’ve written to support to see if they have any suggestions but have yet to receive a response.

    • Steve: You might see that depending on how large the photos are and how many of them you have inside one text document within your project. If you’re outputting to another word processor, it might be better to add the images in after you compile. I hope you hear from L&L soon. They’re usually pretty good at responding, but they’re a small crew. Sorry I can’t be more help.

  10. Thanks Gwen. I have only been using Scrivener for two days now, but it is an awesome tools. I have bought your Kindle version of ‘Scrivener for Dummies’ and find it very helpful as I do your blog. I am using Windows platform. I can copy in an image using Cut and Paste as suggested and it works. I tried using your suggestion to put the images elsewhere (first I tried as a Folder under Research and then within the Manuscript itself) and to reference the image as you suggested by entering

    directly into the text. But when I Compile, I do not get the image, only the text string as presented above. I do not appear to have a typo and cannot figure out what is wrong. Is this feature supported in Windows? I cannot find any explicit documentation that it is not.

    Also, when I use the actual image imbedded into the text, regardless if I center the text, or right align it, it still appears left aligned when Compiled? I notice most of your images in SFD are left aligned also, but some look right aligned. I am not sure how to control this.

    And sorry to beg your patience further and it may be covered in another blog post, but I want to use exactly the same type of TOC you use in SFD. Parts and Chapters numbered sequentially and continuously. Currently it appears to be numbered mixed together (as I am using for both. (Also, I would like to have some Up Front ‘chapters’ such as Preface, Acknowledgments, etc. treated as being in the TOC but not having a Chapter #. I have figured out several ways to do that so not to worry.) Are there two different type of Placeholders or do you have a suggestion on how to get this right.

    Finally, I am not certain that I like the way the TOC is automatically created anyway for ePub and mobi formats, so wanted to just use my own TOC with hyperlinks and be able to override and ignore the automatically generated TOC. It is clear from your TOC in SFD that you have either figured out the way to generate it perfectl,y or used your own TOC Text file and compiled ‘as-is’ and were able to ignore the automatically generated one, or you must have edited out after having Compiled.

    Any help would be most appreciated. All I can offer in return is (1) I promise to write a good review for the book on Amazon and a blog post on it, and (2) I am an avid learner and experiment a lot to get the perfect templates and may be able to provide some good fodder for your blog posts or test out and try to solve some problems on your behalf. Thanks so much for SFD and this and any help you can provide in response to this comment on your blog.

    (BTW, my current book is on wine and I have previously published another book (both done in Word, but now switching to Scrivener for my WIP) under the pseudonym Blake Stevens.

    I understand in advance if you do not have the time to answers my several questions in addition to the other many you must receive, but if you can, it would be most appreciated.

    Keep well!

    • It appears my line of ” ” did not show up when I posted the previous post. That may make a portion of the post non-sensical.

      If it happens again with this post, I will try to explain in text. Also, I figured out why my images were getting Compiled to the Left. That is the way I have my Text formatted in the Compile option. When I switched to using the ‘as-is’ flag, it corrected it. Seems strange though that you cannot use centered text once or twice in a document where almost all other text is left aligned. You could make a next level down document but that creates problems on its own.

      • It happened again. I am trying to use the image tag as you mentioned above with the $ sign before the ‘img:’ followed by the image name all enclosed in brackets. That is what is showing up as text when I compile – the image is not showing up.

    • Steve: I’m glad you’re finding SFD and the blog helpful! The reason you’re only getting the text and not an image is because Windows doesn’t yet support the image tag. I did mention that in the 2nd paragraph above, but it’s easy to skip right over when reading. Hopefully, the Windows version will catch up soon in that area.

      As for centering, that’s a tough one. Since Windows doesn’t yet have preserve formatting, the easiest way to get the book to look the way you want it is to set everything up as desired in the editor. Indents, centered images, font, everything. Then, when you go into Compile, choose Original from the Format As dropdown box. This will keep everything as you’ve set it up in the editor. You can still make adjustments to some of the settings. The main Compile tab this affects is the Formatting tab. You can still use the checkboxes to include titles, but you won’t want to click the Override Text Notes and Formatting box. Once you do, it’ll change everything. The downside of this approach is that you can’t autonumber your chapters. However, you can still have a TOC.

      As for the TOC, it’s based on every element that gets a section/page break, and is automatically generated. Right now, there’s no way to turn it off. If you like working in Scrivener, but find it’s not yet ready for your e-publishing needs, you might try generating the epub in Scrivener, then using the free program called Sigil to tweak it. You can find Sigil at Sigil lets you view the file in WYSIWYG or HTML.

      Just a note, I didn’t format SFD for epub. My publisher handled all of that, and I’m guessing they used HTML to do it. :-)

      I hope that helps some. Good luck with your books!

      • Thanks so much Gwen. And apologies for quickly reading over and misunderstanding the notation that image tag not yet supported in Windows. I am learning more and more advantages of current Mac version over Windows version of Scrivener.

        I have been wrestling with and trying to push to the limit having one source copy in Scrivener to minimize manual changes at the end of the publishing workflow and will continue to push that, but need to recognize that it is just not possible to do completely. Thanks for the reference on Sigil – I will certainly download it.

        After much more experimentation, I have come to do exactly what you mentioned. I can do all this formatting exactly the way I want to in Word, so I am no longer really valuing the editing or compile components of Scrivener, but still greatly value using multiple windows for improved efficiency in re-writing and restructuring sections and the project management capabilities that I had been doing separately.

        Thanks again!

      • Gwen, thanks for the tip on Sigil. I have started to use it and it looks like a brilliant freeware program for editing ePub / HTML / CSS. I have now proven I can do everything I need in our just outside of Scrivener and just converted my 90,000 word WIP to Scrivener, and finally back to writing instead of figuring out the technology. But the small diversion was well worth it as my productivity has increased significantly and I have learned a lot in the process.

        Back to writing! Thanks again.

  11. BTW, I love the idea of using an image as a separator after the Chapter Headings. Very classy idea! Now I just need to find the right image for my wine book. Thanks.

  12. Gwen
    Thanks for this post. I followed the instructions and it worked beautifully to insert images into a manuscript I’m helping a friend with. When she decided to change the images, I deleted the former one, imported the new ones and set up the tags again, but they are no longer appearing. After re-reading this post and all comments, I can see that the problem is probably that the blue highlight is no longer appearing around the tag. I’ve reapplied Preserve Formatting but that has not solved the problem. I’ve carefully checked the form of the tag to be sure all elements are included and in the right order. I can’t imagine what I’m doing differently.

    I’d appreciate any suggestions you have. Thanks.

  13. THANK YOU!!!

    I’ve been trying for two days to figure out how to get my book cover image in Scrivener, and I had searched everywhere on the Internet, but you are the first one who mentioned that you couldn’t put it in the manuscript/draft folder. That was extremely helpful. I couldn’t figure out why it would only insert text docs. Thanks for sharing. You’re a life saver! :)

  14. As always, I should have looked here first. I’ve been trying to get this info for so long. Any idea when img tags will be supported in Windows?

    • Sherrey: My understanding is that Windows is supposed to catch up to Mac by early next year. Of course, software development is notoriously hard to predict, but that’s the plan. :-)

  15. Hi Gwen! Hope you can help. I’ve searched everywhere but can’t find an answer. How come when I right-click on a folder “Add – Existing Files”, the image files on my folder can’t be selected? Also, is it any different from simply dragging an image to the document? Although I did notice that when exporting to PDF, the images are pixelated. Help, please! :)

    • Reev: My guess is that you’re trying to import to a folder that’s within the Draft/Manuscript folder. If so, you can’t do it. You have to be on Research or one of the other folders outside the Draft to import files that aren’t text-type.

      You can drag an image directly into a document in the Draft/Manuscript folder, but you can’t import the image as a file itself. Scrivener wouldn’t know how to treat a stand-alone image file during the compile process. Make sense?

      Not sure why the images would be pixelated. They should be at the same quality as the original. If you’re taking a low-quality image and enlarging it, that might cause your issue. Hope that helps!

      • Thanks for the quick reply Gwen. Appreciate it.

        Yes, I missed making a folder outside the Manuscript folder. My apologies. :) However, after adding the existing file, when I type “”, replacing the “ImageName” of course, and export to epub, the image doesn’t appear, only the command which I typed.

        Dragging an image into the document, from outside the program, yields the same result after exporting to epub. So my follow up question is, why would I need to “add as existing file” when the image dragged from outside the program shows up after exporting to epub anyway?

        With regard to the image being pixelated, I think my problem is “size”. Here is a screenshot of my exported PDF:

        The first line is text typed directly into the editor; the second is an image dragged from outside the program and not resized; the third is a duplicate of the image resized, to match the size of the text in the first line.

        The third one seems the right size—but only in PDF. When I export the document to epub, it’s too small. The second one is actually the correct size (when exported to epub) but appears too big in PDF.

        Sorry for the long post. I’m trying to find a way to be able to export to PDF and/or epub without having to keep changing the file size of images. I’m using this font (image) for each chapter in the novel I’m writing and it would mean double the work if there’s no workaround.

        Hope to hear from you again. Thanks!

        • Reev: I’m not clear what “” is supposed to represent. There shouldn’t be any quotes in your image tag. You don’t have to import the picture, but since you only have one, it makes referencing it easy, and will let you do the fix below (though you could reference it on your hard drive instead). I do agree your pixelation issue is quality related.

          So, I have a fix for your need to have different sized images for different types of outputs. What you can do, is insert the image tag for the file in one size, say the smaller size for PDFs. So it might look like at the beginning of each chapter. Then when you’re ready to compile for EPUB, you go into the Replacements tab and replace the with something like . I’m attaching a link to a screenshot that shows what I’m talking about. You don’t need to check any of the checkboxes in the Replacements tab. I used a Preset replacement so it would be available to any project where I apply that saved preset (see the next paragraph), but you can use a project replacement instead.

          If you’re going to do this more than once, after you get it working properly, I’d save your EPUB setup as a compile preset, which you can do by choosing Manage Compile Presets from the Format As drop-down list. Then you won’t have to remember to do this every time.

          Here’s the screenshot link:

          I hope all that makes sense. :-)

          • Hi Gwen. I think what I posted in between the ” ” was prevented from showing up on your blog. It was the command you insert for pictures (the less-than sign, followed by a dollar sign followed by img:Imagename). It’s what shows up when exported, not the image. I’m sure I missed something again.

            I will try out your fix and get back to you. Is it safe to assume that it will work even if every chapter has a different image-title?

            One workaround I do is export the document as epub then do some hand-coding in Sigil. I’m really hoping I can do all of it in Scrivener.

            Thanks so much!

          • If you’re seeing the tag and not the image, then something is entered incorrectly. Double-check the image name and the tag. If you have different image names for each chapter, but their sizes are the same, you can just replace the PDF size with the EPUB size in the Replacements tab (i.e. replace w=100 with w=400). Otherwise, you may need to add a line for each of the various size changes you want to make. That or a replacement line for each image tag if they’re all unique sizes.

            EPUBS usually come out really well in Scrivener without any extra help, but it depends on what you’re trying to do. You can get rid of first line indents at the start of a chapter, make the first few words of each chapter be uppercase, and so on. The only thing I know of that you can’t do is drop caps.

            Good luck!

          • I will resort to replacing each image-title per chapter because all have various widths. Thank you!

            I also noticed that some ebooks have different top-margins. For example, my novel has 3 acts and each acts begins with an image-title. But I want the image to be around 2-3 inches lower from the top…as opposed to the standard 1-inch margin on normal chapters. All I do is press Enter until the image goes down. Problem is, this looks ugly when exported as an ebook. Is there a proper way of setting different top-margins on different pages?

            Btw, I’m really grateful for you sharing your expertise here (as a supplement to your SFD book). If you had video tutorials, say at, I’d subscribe to it! :)

          • Reev: I’d use page padding in the Formatting tab of Compile. You’ll have to apply it to the folder or text level that the Acts are on. I’ll have to check out Several people have mentioned it to me. Thanks!

          • “The only thing I know of that you can’t do is drop caps.”

            Do you know if this is still true. Can you think of any easy way to take a Scrivener-produced ePub or .docx or whatever and do this? I’ve tried it with LibreOffice and it Drop Caps every single paragraph. (Which is weird, since LibreOffice used to do it on just the first letter of the first paragraph of the chapter, except with a bug – it would also drop cap a double quote if that began the paragraph/chapter).

          • Jeff: Still no drop caps in Scrivener. You could try using Sigil to manually make the change once you’ve produced the EPUB.

  16. Hello Gwen,
    Thanks for the well-written article and for your responses to comments so far. I’m in the same boat as many others–using scrivener on Windows and trying to format images. I tried directly copy and pasting them into the document but when I print it out it becomes a huge mess with the images frequently getting broken in half. As you said, scrivener seems to format them as as though they were text, and so the image is automatically padded with white space corresponding to the “font size” (i.e. image size) which makes formatting impossible. Since we can’t insert images w/ the tag, and we can’t seem to directly insert them with copy and paste, are us Windows users just out of luck until scrivener updates?

    I know this is no fault of yours, but I have to admit I am pretty miffed that this functionality isn’t supported, especially since the website clearly advertises the program having this functionality (

    • Adam: You should be able to resize your photos after you paste them in. Just right-click and choose Edit Image. Also, it’s definitely best to offset them with a paragraph return above and below. If you’re producing ebooks, this is probably best for the reader’s experience anyway.

      I understand your frustration. Just know that the Windows version is doing a great job of catching up, especially considering they started five years later. It’s already many leaps ahead of the Mac version I started on. And not only are they trying to catch up to the current Mac version, but stay aligned with whatever Keith has planned for Mac in the future. A tough job for sure!

      Scrivener’s original purpose was as a drafting tool, so image support has been slow to catch up, but it’s coming. Hang in there!

  17. Hi Gwen, Can you Help me? I am putting together a childrens’ picture book. I have 31 jpg images and no text. I am using a mac. I have been able to drag and drop the images into the scene folders to create the story. However, when I compile the story into an e book nothing happens ( I just get either a spinning wheel or a book with only the cover image displayed). What am I doing wrong? Thanks much.

    • Okay from reading the posts I realized that I should put the images in the research file. I imported them into the research area, but they are not showing in the ebook when it is compiled. I only get my title page and then blank pages. Is there another step?

      • Carmen: Images as files cannot be stored in the Draft/Manuscript, but they can be inserted into the text documents there. So, you need to either drag the image from your Research folder to insert it in the text document where you want it, or use an image tag as described in this post to insert the image where you want it. Then, when you compile, ensure the text documents that have all your images in them are included (on the Contents tab). I hope that helps.

        • Gwen – Im afraid that I am getting frustrated. Is the Dummies book better for step by step instructions? I have it on request at the library. I am an artist and use photoshop and illustrator but this program has me completely stumped.

          Today I moved the 31 jpg images from the research folder to the Binder and broke down the images into 3 Chapters and 6 scenes.I believe these are the “text documents” you referred to in your response. I could not drag from the Research Sample Output folder (as you suggested) so I cut and pasted each image. Now I have the same images in a Research folder and in the binder Chapter folder(s) (text documents). Again no luck in compiling to an ebook.

          So, I thought I would remove the images in the binder Chapter folders and insert the “$img:name” code instead. But I am a bit confused because when I looked over the instructions in your post it reads, #2 “Select the desired document, and click within the editor in the exact location where you’d like to insert the image.” Should I select the desired document meaning the image files in the research folder or select the desired document meaning the binder chapter?

          Sorry Gwen, I am trying and appreciate you helping me to figure it out.

          • Carmen: The book is way more in depth than I can be here on the blog, and has lots of screenshots. And more importantly, you can start at the beginning to learn the terminology. I think that’s where you’re really struggling. In fact, if the book won’t be available for a while, I’d recommend you go through the tutorial before trying to go any further with the program. You can access it from the Help menu or the New Project window (File–>New Project). There are also quite a few video tutorials online, also accessible from the Scrivener Help menu.

            Basically, there are folders and text documents. Folders have a folder icon (except for the Draft/Manuscript folder, the Research folder, the Trash, and any others that came stock with the template you chose), the text documents look like a piece of paper. You can add a text document by selecting the folder you want it in and going to Project–>New Text. So, when I say to drag the image into the text document, I’m expecting you to select the document in the Binder, then drag the photo into it in Editor pane in the center of the screen, where you would normally type. This is similar to copying and pasting into it. Or, you can type the $img tag into the text area.

            The next thing to consider is that your documents must be subitems of the Draft/Manuscript folder or they won’t be included when you compile.

            Really, I’d check out the tutorial and then see if my comments (and post) start to make more sense. I hope that helps.

          • Hurray and bless you Gwen! I finally got the images to show up in the ebook compile. I’m getting the Dummies book from the library tomorrow. Your extreme patience is very much appreciated.Thank you-

          • Buy the book. It is an invaluable source to have besjde your work area! :-)

  18. Hi Gwen,
    In a project for ebook, I want to write a small description/title of an image just under it, AND I want this single line to never break from the image like it might when people use different readers or they choose to change the font size. Is there a way to make sure a page break does not occur between the image and the text underneath?

    • Great question, Ferd! I had to look this one up, but yes, there’s a way to do it, at least for Mac. I don’t have access to my PC right now. You should be able to select the line the image is on (or select the image if you really want to), then go to Format–>Text–>Keep With Next. This adds an invisible character to the paragraph the image is in (usually on its own) that forces it to stay with the following paragraph (in this case your caption line). HTH!

  19. Great post, Gwen! Quick question. Is it possible to use percentages when you use IMG tags? Such as

    • WordPress seems to have stripped the code from question. Basically, I’m wondering if after ImageName in the tag can you use w=100%


      • Dan: As far I can find, the width and height parts of the tag only support pixels. If you use an image tag without specifying size, it should use the actual size of the image file. So, you could resize the picture ahead of time. If you want to be able to scale it based on the type of output you’re creating (e.g. EPUB vs. PDF), you can use the Replacements tab as I outlined in my responses to Reev on September 21, 2013 at 3:42 and 5:50. HTH!

        • Thanks for the response, Gwen! Actually, scaling it based on the type of output would be ideal. I didn’t realize you could do that in Scrivener.

          I have a book with about 40 images. I’m trying to export an ebook and a print-ready PDF from the same Scrivener document. The ebook version will use lower resolution JPG graphics to keep the size of the epub/mobi down, and the print-ready PDF will use 300 dpi TIF images. If the images are the same height and width, only different resolutions (ie. house_400x300_72dpi.jpg and house_400x300_300dpi.tif), is there a way to use the Replacements tab to swap all images based on the type of export I am compiling?

          Think I’ll pick up your book today. I’ve heard nothing but good things!

          • Dan: I would select the Preset Replacements button on the Replacements tab. Then set it up to replace _300dpi with _72dpi (assuming all of yours are named that way). Then when you have your compile settings all ready to go for your ebook, save them as a preset (go to Format As–>Manage Compile Format Presets and click the [+] button). This way the replacement settings are only saved in that preset (accessible from the Format As drop-down menu). When you choose different preset for your PDF, the replacement settings won’t be there and Scrivener will use the high res images.

  20. Gwen,

    Thanks for this post – very helpful – I’ve looked long and hard for this info. Thank you! Question; how do you center your image?


    • Absolutely, Scott! Glad it helped. If you have the image itself inserted into the text, you should be able to apply centering and have it stick. Apparently, images have a sort of built-in “preserve formatting.” If that doesn’t work, or you’re using the image tag, select the image or the image tag, then go to Format–>Formatting–>Preserve Formatting. The selected image/text will be highlighted in blue with a darker dashed border. This is Mac only right now. HTH!

  21. Gwen the formatting you suggested worked for centering! Thank you!!!!

  22. I have a question, I didn’t see it covered so apologize if it was. I am attempting to input a dozen images throughout my text-book. I want to format this book to an output file of epub, mobi, pdf and for print. So the question is, how do I know what sizes to designate in terms of height and width? Thanks!

    • Justin: I’m not an expert on using photos in ebooks. When I created PTFW, I played with the sizes in the Kindle Previewer and decided on w=500 for full screen shots, and w=300 for smaller images. My understanding is that if an image is too big, the Kindle will scale it to fit the screen width. The bigger consideration may be image file size. Kindle recommends no more than 127KB, but the highest quality possible, preferably at least 300dpi.

      Note that if you don’t specify a height and/or width, Scrivener will just insert the image at its actual size.

      Wish I could be more help on this. You might check out these pages at Amazon, though I found them annoyingly vague on the subject.

      Again, playing around with the Previewer might be your best bet. You can get it here:

      Good luck!

  23. Thank you, this is going to come in extremely handy once we have the charts created! I was looking for a way to mark the text where the images should be inserted after compiling, but this is even better.

  24. Morgan Kegan

    May 3, 2014 at 23:28


    FYI, there’s a known bug in the Mac version of Scrivener affecting images that’s very frustrating if you aren’t aware of it. If you have the “Downsize and resample inline images to visible size” compile option turned on, all images end up left-justified, regardless of what you do. The CSS that’s applied to the image is being generated incorrectly. The details on this bug can be found at

    There’s something else you should be aware of, too. If you decide to use an image for your scene break, Scrivener will make a separate copy of the image file for each use of the scene break, and insert that copy into the .epub or .mobi file. This bloats the file enormously, enough to trigger the download surcharge Amazon charges. Not good.

    The only fix I know of now is to generate a .epub, edit it in Sigil, do a search and replace on the image file name so all the image tags refer to the one same file, then delete all the extraneous copies of the image from the image section of the file. Save it, and open it in the Amazon Previewer, and it will generate a new, slimmer .mobi file for you.

    • That’s great information to have, Morgan. Thanks for sharing!

    • So the bug has its own thread! Editing in Sigil has been my workaround too. Until they come up with a new version or bug fix, I won’t be relying on Scrivener for proper image handling. Thanks Morgan!

  25. Hi, Gwen. I have your book, Scrivener for Dummies, and it is super. However, I’m having a problem inserting images into a Scrivener document to be output as an ebook. When I drag the image into the document, there is far too much space above the image, but the proper amount of space below the image. I’ve tried to delete lines above the image to reduce the space, but this doesn’t seem to help. Can you suggest a fix? Thanks.

    • Thanks, Charles! The first thing I’d check is the line spacing of the image. If you have double-spaced (or anything greater than single-spaced) text, you’ll get extra space above the picture. To fix it, select the image, then change the line spacing to 1.0. Hope that helps!

  26. you say “NOTE: Images cannot be stored within the Manuscript/Draft folder.” but that appears to be what my ‘book’ is in – DRAFT. how do i change that so i can add images. I made a folder ‘images’ but it won’t let me add to it, thanks

    • Sam: You can’t store image FILES in the Draft folder, but you can embed/insert the image itself within the text of a file that is in the Draft folder.

      So, your Images folder will need to be located outside of the Draft, but you can drag and drop an image into the text of a document in the Draft. Make sense?

  27. so there isn’t a way to insert images that text can wrap around–as in a webpage where images are “embedded” beside a paragraph? (forgive me if that question has already been addressed in the comments thus far)

    thank you!

  28. Hi I was hoping you could help me with this. I tried for hours and hours to get the image embedded per your instructions above and all I got was broken links in the .mobi (kindle) files that said: “Images/break1.jpg” width=”150″ height=”9″ alt=Image”/>

    I couldn’t even get the epub version to work it all. I just got big red text boxes that said: Error

    Ok so it didn’t work out for me. But after I scrubbed all the coding from my compiling presets I can’t get thing out!! Every compile is clean of everything, but it still spits out the above error! Starting to freak out a bit…. been at this all day long.

    • I manually inserted one image on my title page, maybe that is the problem?

      • Rachelle: If you manually inserted the tag in your title page, you’d have to remove it from the title page to get it not to print. I assume you’re using a Mac. As mentioned in the post–but a few have missed it–the img tag doesn’t work in Windows. If you still want to use the tags, make sure you use the full file path for the image. In my tests, a partial path doesn’t work. Also, make sure the image file name is correct.

        Maybe you could use the Contact page above to email me directly. I’d love to see the actual text of the image tag you used. In my tests when I enter it wrong, I don’t get an error, just no image in the text.

  29. I got so excited when I saw that I could incorporate images in chapter headings… and then noticed that as of when you wrote it, the img tag isn’t supported in Windows. Has that changed? Will it change at some point (if you know)? I do love Scrivener, but this functionality is important and I hate to drag everything into word to add this if it’s going to end up as an ebook anyway. Any kind of workaround you can suggest??? Huge fan from SPP!

    • Jennifer: It hasn’t changed yet, but my understanding is that the L&L guys are going for full feature parity when 3.0 releases. Until then, you could put an image or link to an image (Edit–>Insert–>Image Linked to File) directly into the text of the chapter folder (select the folder, then go to View and uncheck whichever group view is selected to get single document view). Then make sure when you compile you go into the Formatting tab and check to include Text for the folders.

  30. Uggg! It’s November 2014 and STILL no image support for Windows! Has a date been announced for 3.0? If so, when? Also, does Schrivener AUTOMATICALLY update, or do we need to manually do it each time? And if it DOES auto update, will the program notify us?

    Finally, please allow me to extend a huge word of THANKS for all you do for us Schrivener green-horns out there! Not only did you write a terrific book on the topic, but you also provide regular lessons at what must be a great cost of time. God bless you, Gwen!

    • philandersonwriter: Yeah, still no placeholder for images. :-( No official word on 3.0, but it is supposed to come out sometime next year. I’m thinking mid to late 2015. Scrivener should notify you of any updates and give you the option to update manually or ignore. You can also choose for all future updates to be automatic, if desired. If you’re not sure if you have the latest version, you can go to Help–>Check for Updates (requires an Internet connection). You can choose Help–>Keep Up To Date to sign up for their very infrequent newsletter. The upgrade to 3.0 will be a paid upgrade, but you should get a discount for already owning the software.

      Thanks for your kind words. I really appreciate. Always glad to help. :-)

  31. Hi Gwen, thanks for a really helpful post. I am on the finishing stage of a translation but I’m having problem with the margins on the pictures. I want the cover and chapter pictures to cover the whole page but Scrivener puts a margin on them. Is there any way of working around this problem? Saludos

    • matiasbravojara: Scrivener does not let you adjust margins on a page by page basis. They apply to the entire project. So if you don’t want margins on a cover page or other pages, you’ll need to compile your manuscript to a workable file type (e.g. RTF, DOC/X) and make changes in another program. Good luck!

  32. Thank you for your crisp, clear directions on images! They are working well for the most part. I do have one issue, I’m wondering if you know the answer.

    Right below four of my scene separators, my final compile is showing three asterisks (***). I have 37 chapters with many, many scene separators, yet in four places these asterisks show up. Is there some kind of behind the scenes code I can look at, or some field I need to clear?

    Thank you in advance for your help.

  33. Hi Gwen, Thanks for taking the time to write this post and answer all our questions. I have been banging my head for hours trying to change the line spacing while compiling from scrivener to mobi. In both Kindle previewer and Kindle for Mac the line spacing never changes. I have tried every conceivable combination and nothing is working. Do you know if mobi ignores this and reverts to a default line spacing? The odd thing is that it is respecting the spacing between paragraphs (set to 12 or 24 or whatever). Any help would be appreciated.

    • Maria: In my experience, all of the e-readers do whatever they want to the line spacing, paragraph spacing (Nook e-readers often add extra space here), and font (though they generally try to get close by choosing a serif or sans serif font as applicable). That’s why I tend not to stress too much about formatting for ebooks. I just my layout clean and readable and let it go. ;-) Good luck!

      • Thanks, Gwen. It’s jut been frustrating because it took the interparagraph spacing from scrivener but ignored the line spacing inside of scrivener. I was trying to open up my text a bit, not have it so condensed, but instead I just got these big spaces between paragraphs. And I can find nothing from Scrivener as to why this gets ignored. I have an email in to them as well, so if I find a solution, I’ll post here.

  34. I see several images on this post. Thanks, Gwen!

What's on your mind?

© 2015 Gwen Hernandez

Theme by Anders NorenUp ↑

%d bloggers like this: