Purpose
LinkIt is a tool in the WYSIWYG bar that simplifies creating internal links within your website content. It provides an autofill box that pulls up a list of the targeted internal page and this helps avoid broken links, absolute or incorrect URLs.
When to Use
Use LinkIt whenever you need to link to another page on your website within your content that doesn't require any special attention to be drawn to it.
Elements of Internal Links:
- Link Text: (Limited to 50 characters) This is the clickable text that appears in your content. It should be descriptive and tell users what content they will access when they click the link. Avoid generic terms like "Click Here" or "Read More".
Learn more about how to write accessible content within are "Writing for All People" Article
As you create promos, automatic lists, and work with page content, you will most likely need to link to another page on your website.
This linking function is handled using the "LinkIt" tool, which is an autofill mechanism.
Creating Internal Page Links
To link to internal pages on your site click the link icon then simply enter the title of the page you'd like to link to and then within the pop up window under the "Content" result the page will appear for your to select.
- Note: To link to pages on your site remember to never use the https:// url but to use the title of the page. If the title of the page does not appear in the "pop up" (shown below) refer to these instructions on how to create basic pages for further guidance.
Linking to Files Uploaded to the Media Library
First make sure you have the document or file uploaded within your media library because you will need to have the media item added into your media library in order for it to be found and linked by the site. The media library is also where you can find the name of the media item so that you can link to it using the linkit tool.
When you have the name of the media item you can then go and select the text you want to have create the internal document link to and then within the "Link URL" field you will then simply enter the name of the media item and it will "pop up" for you to select.
Learn how to upload to your media library
Note: To avoid broken links and absolute linking as well as broken links it is important that you use the name of the media item for linking to anything that is internally within the site and not the https://
Creating External Links:
For an external link, for example to "directory.iowa.gov", simply select the text you want to link
Use the chain link icon (which is also referred as our linkit tool)
and paste the link to that you want your audience to be directed too. This can be an external link to a google doc, external website, etc.
- Lastly to apply your link select the green check mark and your hyper link is now created!
Your link will now automatically have an indicator icon that displays as an internal or external link.
Phone Number Links
You can add the number of your location turn it into a link that mobile users can select and initiate a call. A simple method to do this is to select edit within the relevant page and then highlight the number and use the linkit tool and add the text "tel:" and then your locations number.
Example of linking a phone number:
Linking inside a Landing Page Hero
As currently created, a link inside the Landing Page Hero fields, will allow an internal or an external link which can be done within the "Edit" button of the landing page.
Let's Learn How to Locate and Fix Broken Links on our Site
How to locate broken links
You can easily identify broken links on your site through the weekly reports sent to agencies by Acquia Optimize (formerly known as Monsido).
Within this report you will that the Quality Assurance section will show the number of broken links and potential misspellings on your site:
Acquia Optimize can also show you each page that the broken link appears on, you will first need to make sure you are logged into Acquia Optimize and then select the "Quality Assurance" button:
From there you will then select the "Unique broken links" section to pull up the list of the broken links.
Within this list you will be able to see each page that has the broken link by selecting the page number which will cause a pop up window to appear that has a list of all of the pages with that broken link:
Next to have Acquia Optimize to show you where the broken link is at within your page you can select the magnifying glass icon within the right corner of the pop up window.
If you have Acquia Optimize web browser extension added it will appear on the right side of the screen after you click on the magnifying glass.
Now if the web browser doesn't automatically highlight the broken link on the page after you've clicked on the magnifying glass you can still easily locate it by clicking on the magnifying glass within the web browser pop up window and it should then highlight where the broken link is on the page.
How to fix a broken link
Once you have the broken link located on the page you can now fix the broken link by selecting the edit button that is above the title of your page.
Within the page edit section you can now click the broken link and then to fix it you can select the the pencil icon which will appear when you click the link text:
After you now have the link fixed make sure to save the page and then within the within the web browser window you can mark the broken link as fixed by selecting the check mark:
Or you can also mark the broken link as fixed within the Acquia Optimize page by selecting the "Open page details" button next to the magnifying glass
From the new window that pops up you will select the action button and then you can select the "set to fixed" to also mark the broken link as fixed so that it removes it from your report and thus improving your Quality Assurance score!
