Why am I seeing 'Asset does not exist' message in my Publish Notification?

This particular message indicates that the asset being published contains a link to another asset that the system is unable to locate. Refer to the following output from the Broken Links section of a sample Publish Notification:

[Destination: Production Web Site] about/staff/directory
Link: /about/staff/john.html 
Reason: Asset does not exist.

In this case, the about/staff/directory page being published contains a link to /about/staff/john.html:

<a href="/about/staff/john.html">John Smith</a>

which does not exist in the system.

The solution here is to verify that the link is pointing to an asset that is managed within the system. It's important to note that file extensions for page assets are not added until the final steps of the publishing process. This means that while the page asset /about/staff/john may exist, you should not include the file extension when referencing it, since that is added automatically during the publishing process. The link should be written as:

<a href="/about/staff/john">John Smith</a>

Notice that the file extension has been removed from the link's href attribute.

Similarly, when creating a link to a folder, be sure to link to the folder's index or default page, and not the folder itself. For example, a link to the /about/contact-us folder should be written:

<a href="/about/contact-us/index">Contact Us</a>