Terms to know
“Dashboard”: Your admin dashboard at admin.airmason.com
“Editor”: The AirMason editing platform when working in the document itself
“Anchor”: The marker within a document you want to navigate to
“Handbook URL”: The unique URL for the document you’re navigating to
“Source”: The document you’re creating anchors in
“Destination”: The document you’re directing readers to
Guide to Anchor Links on AirMason
Anchor links are primarily used on AirMason to create easy navigation to specific pages within a certain handbook. They can be used within the same or a different AirMason document. Examples include:
Directing readers to a specific clause or section
Linking from a condensed/short-form policy to the full legal text
Jumping readers down to a different section (and then back up to where they started)
Once an anchor has been placed and published, the document’s URL can be modified to send readers to that exact spot. This is achieved in the form of a # which drops you in at the anchor. For example:
In the organization “Test Account”, /anchors is the document we’re viewing and #dress-code is the anchor (AKA bookmark) we’re being dropped in at.
How to create anchor links on AirMason
Below you will find instructions for creating anchor links within the same and to a different document on AirMason, including step-by-steps and how to test they work correctly prior to launching.
1. Navigate your cursor to the word or place you want to anchor to
AKA where you would like the hyperlink to drop readers into the document at.
2. Click the anchor icon in the toolbar
3. Type a unique, memorable tag for this specific anchor, then click Ok
*Note: Case sensitive, no spaces allowed.
4. Voila! You will notice a little anchor icon has appeared on the page. Your anchor is ready to be linked to and can be placed at the end of your handbook URL as #anchortag
An example URL which wants to drop the reader to our dress code policy: https://books.airmason.com/testaccount/anchors#dress-code
The URL us constructed of the following:
books.airmason.com/testaccount < your organization subdomain
/anchors < the handbook we're pointing towards
#dress-code < the anchor we're dropping in at
To see it live, click this link.
Creating a hyperlink to an anchored document
1. Once you've placed your anchor, find and copy the unique handbook URL for your destination document by hovering over the 3 dots and clicking Settings
2. Under HANDBOOK URL you will see the option to COPY
3. Open the Editor to your source document and highlight the text you’d like to hyperlink, then hit the icon on the toolbar
4. Insert the handbook URL for our destination then add a # and the relevant anchor tag you just created, and Ok
5. Your hyperlink is now created to send readers to that particular spot in the document!
Read on for more about testing and troubleshooting anchored hyperlinks on AirMason.
Testing anchor links on pre-launched documents
Because anchors need to be published to become functional, you’ll need to “launch” your document on AirMason in order to test if they’re set up correctly. Note: once you’ve confirmed everything works, please contact email@example.com to have your document reset to Unpublished prior to officially launching.
To test your anchor links:
1. Follow the launch wizard to launch your destination document as a Public Link (this can be updated later and is for testing purposes only)
2. Close this window, then go back to your dashboard and open the preview link for the source document you’re linking from
Related article: How to find your document's preview link
3. Find the anchor link you just created and click it – this should take you to the document you just published at the specific anchor you set (see below for troubleshooting)
Troubleshooting anchor links
If your anchor link isn’t functioning as it should, check the following:
Destination has been published/launched since they were inserted
Handbook URL being linked to is correct and contains required protocols (https:// etc.)
Your anchor tag spelling and case matches perfectly in both anchor and URL
URL contains the necessary # symbol before the anchor
If anchoring in a pre-launched document:
Check that the destination document has been published as a public link (other settings will require login and not work for testing)
For any further support, or to talk through use-cases and best practices for using anchor links on AirMason, please contact firstname.lastname@example.org or reach out to your Customer Success Manager.