How to Fix INCLUDEPICTURE with a Bookmark Failing in a Word Header
Question details
The user is trying to display an image dynamically inside a document header or footer by using the INCLUDEPICTURE field combined with a bookmark reference, but it is not rendering properly.
- Product
- Microsoft Word
- Device & OS
- not provided
- Scenario
- Inserting dynamic, updateable images (like letterheads or logos) into document headers or footers using field codes.
- Observed behavior
- The INCLUDEPICTURE field successfully retrieves the image when placed in the main document body, but fails or displays an error when inserted into a header or footer story.
Verify that the referenced bookmark (e.g., 'LetterHead') actually exists in your document and that it contains the exact and correct file path or URL to the desired image.
Insert and Update the Field Code Directly in the Header
Because headers operate in a separate document layer, manually creating and updating the field code inside the header forces Word to evaluate the bookmark reference correctly in that specific location.
Header and footer stories handle field references differently than the main document story. Copying and pasting an existing field code from the main body into the header will often break the connection to the bookmark. The best approach is to generate the field directly from within the header editing mode.
Double-click the top margin of your document to open the Header & Footer editing mode.
Press Ctrl+F9 on your keyboard to insert a pair of empty field braces { } directly into the header.
Type INCLUDEPICTURE "{REF LetterHead}" inside the braces, ensuring 'LetterHead' matches your actual bookmark name.
Highlight the field code you just typed and press F9 to manually update the field and display the image.
Insert the Image Directly into the Header
If the bookmark reference remains unreliable across document saves or updates, bypassing the field code and inserting a static image directly is a much more stable workaround.
Easily Add Letterhead Images with WPS Writer
Avoid complex field codes and bookmark errors altogether. With WPS Writer, you can quickly insert and manage letterhead images directly in your headers with an intuitive interface and complete formatting control.
- 1. Open Header & Footer Mode: Double-click the top margin of your WPS Writer document to enter the Header and Footer editing interface.
- 2. Insert Your Picture: Navigate to the Header/Footer tab on the top ribbon and click the Picture icon.
- 3. Adjust the Image: Select your letterhead image, click Open, and drag the corners to resize it perfectly for your document headers.
Frequently Asked Questions
Why does the INCLUDEPICTURE field work in the body but not the header?
Word processes headers and footers in a separate document layer (often called a 'story') from the main body. Field codes and bookmarks located in the main body sometimes fail to reference correctly when called from the header layer.
How do I manually update field codes in a Word header?
Double-click the header area to enter editing mode, click on the field code or image placeholder to select it, and press the F9 key on your keyboard to force the application to refresh the field data.
Can I link an image in a header without using the INCLUDEPICTURE field?
Yes. Instead of using manual field codes, double-click the header, go to Insert > Pictures, select your image file, click the small arrow next to the 'Insert' button, and choose 'Insert and Link'. This keeps the image dynamic without requiring a bookmark.
How do I create a bookmark for an image path?
Type the exact file path of the image into your document as plain text. Highlight the text, go to the Insert tab, click on Bookmark, type a descriptive name without spaces, and click Add. You can then reference this bookmark in your fields.
