When Landmark IDs Stay the Same

A Landmark ID in one of the hashed formats, Hashed (16 char) or Hashed (8 char), is a hash of two things: the document's path relative to its project, and the alias or ID of the heading or paragraph. A Source ID Landmark ID is the alias or ID itself and does not depend on the path. So a Landmark ID stays the same as long as both of its inputs stay the same:

  • Projects built in ePublisher Designer or ePublisher Express use each document's path relative to the project file.

  • ePublisher AutoMap jobs based on a Designer or Express project use each document's path relative to that project, so the job produces the same Landmark IDs as building the project in Designer.

  • ePublisher AutoMap jobs based on a Stationery use each document's path relative to the job file.

An AutoMap job never uses the staging folder for these paths, so Landmark IDs do not change when the job runs from another staging folder, another AutoMap workspace, or another computer.

A hashed Landmark ID changes when:

  • the document is renamed, or moved relative to its project or job file;

  • the heading's or paragraph's alias or ID changes;

  • the job file spells a document's path with different capitalization than the project does, for example ..\Legacy\intro.md instead of ..\legacy\intro.md. Keep the two spellings identical when a job must produce the same Landmark IDs as Designer.

A document on another drive or network share, or one that shares only the drive root with the project or job file, keeps an absolute path, so its Landmark IDs change if it moves. When an ePublisher AutoMap job based on a Stationery (a .wxsp file, or a Designer or Express project that the job file references with useAsStationery="True") includes such a document, it warns once for each WebWorks Reverb 2.0 output target it builds. The warning appears in that output target's generation log (generate.log) and in the job log:

Landmark IDs for 3 document(s) include an absolute path because those documents are on another drive or share no folder with "C:\Jobs\Product Help" other than the drive root, for example "D:\Shared\intro.md". Their landmark IDs change if the documents move.

The warning appears only when the Stationery's Base format version is 2026.1. Output targets that use other formats, such as PDF - XSL-FO or WebWorks Help 5.0, do not warn, and neither does WebWorks Reverb 2.0 output with an earlier Base format version or a shell target with Generate Groups disabled. The warning is always in English, whatever the language of the ePublisher user interface.

A Stationery keeps a copy of the output format files from when it was saved. After you install an update, save the Stationery again so that jobs based on it calculate Landmark IDs this way. For more information, see Installing an Update Build Within a Release.

Last modified date: 11/05/2026