LumaCite · Windows Word add-in · 0.2.3 development release

Keep writing.
Let citations follow.

Search your sources, build a citation group, and format the entire manuscript with Citation Style Language.

Install for your Windows account

  1. Extract the distribution archive to a local folder.
  2. Run Install-LumaCite.cmd, or run Install-LumaCite.ps1 with Windows PowerShell. The installer copies the runtime and registers only this user's LumaCite add-in.
  3. Save your work and reopen Word. Open the LumaCite ribbon tab.

The window and Node runtime are self-contained. Windows x64 and .NET Framework 4.8 are required. This is an unsigned development build; organizations that require signed Office add-ins need a signed distribution.

Your first citation

1 · Find and select

Put the Word cursor at the insertion point. Choose Add / Edit Citation. Search My library, This document, or Crossref online. Enter a full DOI for an exact Crossref lookup.

Double-click a result or press Enter to select it. Search again to add another source to the same group.

2 · Refine and insert

Select a source chip to add a page or another locator, prefix, suffix, or author suppression. Reorder or remove selected sources with the controls beside its details.

Choose Insert citation or press Ctrl+Enter. The citations and bibliography are formatted together.

Edit, refresh and choose a style

Click inside a generated citation and choose Add / Edit Citation. Its sources and modifiers return. Removing all selected sources and updating removes that citation. Use Edit source to revise this source's metadata across the document draft.

Style and document filters 2,907 installed independent CSL styles by style or journal name. Select a matching style, language and placement for new citations, then choose Apply style. A custom CSL must contain complete citation rules. A full-note style together with Footnotes or Endnotes creates native Word notes.

Turn off automatic formatting for placeholder insertions and use Refresh Citations when ready to format. This is a document preference.

Useful tools without extra clutter

Cite stays compact. Click a selected source chip for page numbers, prefix, suffix, source order and display. These controls replace the search area; Back to results returns to searching. Press Alt, Z, L, C in Word to open the composer. You can also right-click an owned citation and choose Edit LumaCite Citation.

Style keeps recently used and favorite bundled styles in a quick list. Use for new documents saves style, language, placement and layout preferences on this computer; it does not change existing documents. Custom CSL remains with its document and can also be saved as the new-document default.

Preview citation and bibliography uses the real document context and any citation draft. It is read-only and shows the first three bibliography entries. It never writes to Word. In an empty document it clearly labels an example source.

Narrative display produces Author (Year) with compatible in-text author-date styles. Numeric and note styles require default display. If needed, Style offers Use default citation display; review and apply the change explicitly.

Bibliography formatting stores an optional heading, font, size, line spacing, space between references and hanging indent with the document. Leave values empty to use the document font or CSL layout. Reset clears the overrides. Apply style to save; Word Undo restores the previous text and settings together.

Find citations and work with references

In References, filter by title, author or year. Select a source and expand its citation-location count. Go to citation selects the native Word field; Edit citation opens that occurrence in Cite. A pending citation draft must be applied first so navigation cannot discard it.

Export offers this document, selected document references, or the Local Word library. Select or clear references and choose RIS, BibTeX or CSL-JSON. The local scope includes only references available to this plugin locally; online-only account libraries and attachments are not included. CSL-JSON preserves complete structured metadata; RIS and BibTeX carry common interchange fields.

Review references appears when obvious metadata issues are found and is always available in More. Exact DOI lookup shows current and available values. Only empty fields are preselected. Apply only the changes you choose; existing values and source IDs remain unless explicitly updated. All occurrences in this document update together. Your local library is unchanged. Anonymous, undated and DOI-free sources can be valid.

More → Create bibliography in a new document builds a live reading list from chosen document or local references. Its full sources are embedded, and it has no fake in-text citation fields. Reopen its References tab to export, review or remove bibliography-only records, or use Style to reformat it. The original manuscript is unchanged.

Manage the bibliography and references

ActionResult
Move Bibliography HereMoves the managed bibliography to the captured main-text cursor, outside another field.
Document ReferencesLists the embedded sources; saves them to the local Word library or exports RIS, BibTeX and CSL-JSON. RIS carries common bibliographic fields; CSL-JSON preserves complete metadata.
Save Clean CopyCreates a new .docx preserving document parts and unlinks LumaCite fields in the copy. The original retains live citations.
ImportReads RIS, BibTeX or CSL/LumaCite JSON. A separate Word library stores imported or created references.

Work safely with live documents

Use the add-in to edit generated citation text. If the document changes while the citation window is open, close and reopen the window at the desired location. The old window keeps its draft instead of silently writing to a new location.

The current build requires editable .docx/.docm files without pending tracked revisions or active multi-author editing. Body/table text, footnotes and endnotes are supported. Headers and text boxes are outside the supported citation stories. A normal Word Undo reverses a complete insertion/update. Save normal document versions as part of your writing workflow.

Offline, online and data

Local/document search, formatting, styles and import work offline. Crossref online sends only the search query or DOI you enter to Crossref. Reference metadata travels in your Word file. The library is stored at %LOCALAPPDATA%\LumaCite\Word\references.json. Style preferences use preferences-v2.json in the same folder and exclude document source snapshots. Diagnostics are local and omit manuscript text and raw requests.

The earlier desktop LumaCite library is read without modifying it. Review incomplete author lists and publication metadata before citing. Cloud sync, shared-library permissions, other managers' citation-field conversion, PDF attachments and Google Docs export are future work.

Compatibility and support

Actually tested: Microsoft 365 Word x64 build 16.0.20527 on this laptop. Other perpetual Word versions and 32-bit Office still need separate testing. The source and regression fixtures are included in the project. The style catalog passed a two-source smoke check; this does not guarantee every journal rule or reference type.

For repair, rerun the installer after saving and closing Word. Uninstall with Uninstall-LumaCite.cmd; libraries and documents are retained. Diagnostic path: %LOCALAPPDATA%\LumaCite\Word\logs.