Tackling Broken Links!

Virgil Master (French, active about 1380 - 1420) Astrological Chart, about 1405, Tempera colors, gold paint, gold leaf, and ink on parchment Leaf: 39 × 30.5 cm (15 3/8 × 12 in.) The J. Paul Getty Museum, Los Angeles

Some time ago we published a blog post showing how broken links to digitized repositories on the DMMapp were a problem, causing them to become inaccessible to users.

This was a major problem for us: Researchers count on the DMMapp to find and access digitized colletctions, and it is obviously a major blow to the project if they cannot achieve the one thing they came there to do. Also users that simply want to explore collections can easily get frustrated if they stumble upon broken links.

Embrace the “broken links” problem

But how to fix it? The issue is not caused by us, but is systematic[1]. How can we defeat it? Well, we decided to embrace the fact that links on the internet break over time and that Sexy Codicology was not the one that are going to solve the issue for the whole internet; our strategy would be, rather,  a reactive one: we find a broken link, we fix it.

So we had a strategy. Fantastic! But then we had more than 500 links to test. A daunting task! So in the beginning we decided we would run a script that would periodically check all the links and log the servers’ response codes[2]. Needless to say: this strategy proved inefficient and gimmicky and it would also not tell us if there was a particular repository that many users tried to access that did not work.

We needed something better, which could continuously warn us of issues and help us.

Helping hands to the rescue!

After some creative thinking, the idea popped in our mind: “who better than the DMMapp users themselves?!”

The DMMapp's Broken Link Button
Our solution to the Broken Links issue!

And just like that we started developing the “report broken link” button. With some magic we managed to have Google Forms pick up the reported broken URLfrom the JSON, and send it to a Google Sheet and at the same time notify us. We implemented it in the DMMapp and watched as notifications came in, conflicted on whether to be pleased with the system working, or saddened by the amount of broken links.


What does the “report broken link” button mean for Sexy Codicology and the DMMapp? Well, the main advantage is the possibility to quickly identify priorities between broken links and answer the question: “which link urgently requires an update?”

“But Giulio, all repositories are important! They should be all fixed!”

This is true, and we do our best to have all our links working, but we cannot fix everything instantly because it is only the two of us. So we have to prioritize in some way, and this method we developed is helping us massively!

Here is a practical example:

Graph showing broken links on the DMMapp reported in June 2018
Graph showing broken links on the DMMapp reported in June 2018

This is a graph of the reported broken links in the DMMapp in June 2018. As you can see, the link to the Österreichischen Nationalbibliothek was reported as broken by 7 users, more than any other repository.

This indicates a clear urgency, and we did tackle this repository first[3].


Another advantage of the “Report Broken Link” functionality is that our users can tell us what went wrong: The website didn’t load? Are the manuscripts gone? Did we link to the wrong section of the website?

Graph showing why a broken link was being reported on the DMMapp in June 2018
Graph showing why a broken link was being reported on the DMMapp in June 2018

A vast majority of the broken links reported so far were, indeed, well… broken links that needed to be updated, with just a couple of links that pointed to websites where digitized manuscripts could not to be found, indicating the need to find a better link that went directly to the books.

Fixing it!

Now, Sexy Codicology and the DMMapp are projects managed by a dynamic duo and we do our very best to make sure that digitized collections remain accessible to everyone. Institutions should, though, also consider findability and re-findability when moving collections and URLs. A simple 301 – redirect can go a long, long way in making sure that digitized manuscripts stay accessible.

For example, you once had a digital collection that pointed to a very obscure URL, and now you have developed a new portal where all your collections are properly listed and easy to access. Instead of making the old URL simply die, implement a redirect. Visitors landing on the old URL will be redirected to the new portal, where they will see “manuscripts” and instantly know where to find the material.

Moreover, all the old permalinks, favorites, and links on other website (like the DMMapp) will still provide visitors to your portal. It’s a win-win and it takes so little[4]!

But in our little project, we are very pleased with the solution we managed to come up with. It uses free tools, it is easy to use, and it is effective. So, go ahead! Have fun on the DMMapp and report those broken links! We’ll be there to investigate and fix them. Promised!

References & Footnotes[+]

Giulio Menna
Giulio is an MA graduate in Book and Digital Media Studies from Leiden University, the Netherlands. He is also system librarian at Leiden University Library. Founder and developer of Sexy Codicology and the DMMmaps Project; lover of medieval manuscripts and of all things digital.