Troubleshooting Common Errors

If you get an error that reports that you have a "Duplicate nav", this is typically only the tip of the iceburg. The real problem is that you have two content sources that have the same component version and the same files. In other words, you have a conflict. It just so happens that Antora checks nav files before any other files.

When this error occurs, Antora will list the two content sources that are in conflict in the details of the message. Check antora.yml in both content sources and you’ll see that name and version keys have the same values in both files.

To solve this problem, you either need to update the value of the version key in one of the two antora.yml files or remove one of the content sources.