OmniDocWord Cross-Reference Not Working? Fixes That Help
Fix Word cross-references that stay stale, show errors, skip captions, or won't open the dialog, with a diagnosis table and step-by-step checks.
Your cross-references worked last week, and now they show an old number, an error, or nothing at all. Or you click the command to add one and the dialog never appears. If you write long reports, theses, manuals, or contracts in Word, a broken "see Figure 3" can quietly send readers to the wrong place, so a word cross reference not working problem is worth fixing carefully.
The root issue is that a cross-reference is a field, not plain typed text. It points to a bookmark or a caption, and Word displays the result it last calculated. When the target moves, the bookmark disappears, or the caption uses a different label, the reference breaks in a different way each time. That is why the fix depends on the symptom you see.
This guide helps you find the cause first, then gives fixes for each one. It assumes you have a .docx file open in Word. If your source is a PDF, or a file that was converted from one, cross-references are usually not there at all, and you'll need to rebuild them in the Word original.
Why is my Word cross-reference not working? The short answer
Most failures come from one of four causes: fields that haven't been refreshed, a bookmark or caption that was deleted, caption labels that don't match, or a document state that disables the command. Start by refreshing fields, then check the target and the caption.
| Your situation | What to do | Why |
|---|---|---|
| The number is wrong after you edited the document | Select all text and update fields | Word shows the last calculated result until fields refresh |
| You see a reference error instead of a number | Check whether the target caption or heading still exists | The bookmark the reference points to was removed |
| Some captions are missing from the list | Re-create them with the caption command using the same label | The list only includes captions that share one label |
| The command is greyed out or does nothing | Check for restricted editing and place the cursor in body text | Some document states disable the command |
| Problems started after a conversion or translation | Rebuild the references in the original Word file | Converted files can lose field data or change label text |
Figure out which problem you have
Match what you see against this table before you change anything. Each row gives a quick test you can run in a minute.
| Symptom | Likely cause | How to confirm |
|---|---|---|
| The number is outdated after you moved or added content | Fields have not been updated | Click the reference and press F9. If the number changes, this was the cause. |
| The reference shows an error saying the source was not found | The bookmark or caption was deleted | Show field codes (Alt+F9) and note the bookmark name in the reference code. |
| Only some figures appear in the dialog | Some captions were typed by hand or use another label | Click a missing caption. If its number isn't a field, it's plain text. |
| The dialog is empty for the item type you want | No captions use that label, or the label was renamed | Compare the label in the dialog with the label in your captions. |
| The command is greyed out or does nothing | Restricted editing, cursor outside body text, or compatibility mode | Check whether the file opens read-only or under editing restrictions. |
| The dialog never opens and shows no error | An add-in or setting conflict | Start Word in Safe Mode and try the command there. |
Fix it step by step
Work through the fixes that match your symptom. Start with the easiest checks, since many problems clear up with a single refresh.
Stale numbers: refresh the fields
- Click anywhere in the document, press Ctrl+A to select everything, then press F9.
- If Word asks what to update, choose the option that covers the whole document, not just the selection.
- Check the references again. Printing can also refresh fields depending on your settings, but don't rely on that for a draft you plan to review.
Error messages: find and restore the target
- Press Alt+F9 to show field codes. Find the reference code and note the bookmark name that follows the field name.
- Press Alt+F9 again to turn field codes off.
- Open the bookmark list from the insert area of the ribbon and turn on the option to show hidden bookmarks. Cross-reference bookmarks start with an underscore, so they stay hidden by default.
- If the bookmark is missing, the target was deleted. Re-create the caption or heading, then insert a new cross-reference. Repairing the old broken field usually takes longer than starting over.
Captions missing from the list: fix the caption
- Click into a figure's caption. If its number is shaded like a field, it's a real caption. If the number is plain text, delete the caption and create it again with the caption command.
- Make sure every figure uses the same label, such as "Figure." A label like "Fig." creates a separate list, so those captions won't appear with the others.
- Update fields with Ctrl+A and F9, then open the cross-reference dialog again.
Empty, greyed-out, or silent dialog: check the document state
- Click inside normal body text, not in a header, footer, or other locked area, and try the command again.
- If the file opens read-only or has restricted editing turned on, you need editing permission before the command will work.
- If the title bar shows compatibility mode, save a copy in the .docx format and try there. Older formats limit some features.
- Start Word in Safe Mode (hold Ctrl while you launch it, or use the safe-start option for your system). If the command works there, an add-in is the likely cause. Turn add-ins off one at a time to find it.
Prevent it next time
A few habits prevent most of these problems before they start.
- Create every caption with the caption command. Never type "Figure 1" by hand, because typed numbers never appear in a cross-reference list.
- Use one label per item type, and keep it consistent. Mixed labels split your lists into separate groups.
- Refresh fields before you share or translate a file. Press Ctrl+A, then F9, so the text you send shows current numbers.
- Move captions with cut and paste, then refresh. Deleting a caption breaks every reference that points to it.
- Keep a copy of the .docx before large edits. Restructuring sections is a common time references break.
- Check captions after translation. If a label is translated, for example to a word for "Figure" in another language, captions no longer match the original label and won't appear in the list. Check the output and fix labels in the Word file.
❓ FAQ
1. Does the caption label have to be in English?
No. The label can be any word Word accepts, but it must be the same across all captions of that type. If you change the label, update every caption and then refresh fields.
2. Should I refresh fields before translating a Word file?
Yes. Refreshing first makes sure the text you send shows current numbers. After translation, check the captions and references in the output, since label text may change.
3. What does Safe Mode change in my document?
Safe Mode temporarily starts Word without most add-ins and some customizations. It does not change your document, so you can use it to test whether an add-in is causing the problem.
4. Why do my references show old numbers after I reorder sections?
Reordering by dragging or pasting can leave fields unchanged until you refresh them. Select all text, press F9, and check again.
📝 Summary
Most word cross reference not working problems come down to stale fields, deleted bookmarks, mismatched caption labels, or a document state that blocks the command. Use the diagnosis table to find your symptom, then apply the matching fix. Refresh fields and check captions before you share or translate a file so the references stay correct.
