This documentation refers to an earlier version of Islandora. is current.


This module makes it possible to use the alias-creating tools of Drupal's Pathauto with Islandora objects. Use this module if you want to change the appearance of the automatically generated links to Islandora objects.

The default Islandora URLs for objects follow this path structure: http://localhost:8000/islandora/object/islandora%3Aroot



Release Notes and Downloads

Latest Code on GitHub


Install as usual, see this for further information.


Step 1: Enable custom paths

To enable custom paths for specific content models, first select the desired content models at Administration » Islandora » Islandora Utility Modules » Pathauto (admin/islandora/tools/islandora-pathauto). You can skip this step if you want to create the same custom paths for all Islandora objects.

Step 2: Configure the Path Patterns (URL aliases)

Configure the path patterns using the Drupal Pathauto interface, at Administration » Configuration » Search and Metadata » URL Aliases » Patterns (admin/config/search/path/patterns).

  1. All Islandora objects
    1. You can use the same pattern for all Islandora objects by entering a pattern in "All Islandora Objects."
    2. Leave "All Islandora objects"  blank if you do not want to create aliases for Islandora content models not selected in the Islandora Pathauto configuration.  
  2. Custom patterns for content models
    1. If you selected content models in Islandora Pathauto configuration, they will appear here so you can enter custom paths per content model.

Example of setting up a custom pattern for Audio Content Model objects, and a default pattern which would be applied to all other objects.

Aliases can include the following Fedora-specific elements:

  • Namespace -[fedora:namespace]
  • Object PID - [fedora:pid]

  • Fedora label or object title -[fedora:label]
    • The label will be condensed and word separators will be added based on the configurations in admin/config/search/path/settings.
  • Short PID (the PID without the namespace prefix) -[fedora:shortpid]

For more information on creating aliases, see the documentation for Pathauto and read the FAQ below.

Step 3: Generate Aliases

Use Bulk Generate at Administration » Configuration » Search and Metadata » URL Aliases » Bulk Generate (admin/config/search/path/update_bulk) to generate URL aliases for items that currently have no aliases. Select "Islandora object paths" to generate paths only for Islandora content.


Q. Why don't the datastreams also follow the alias of the object?

A. With pathauto alone, datastreams are NOT accessible at [object alias]/datastream/DSID. To get this functionality, enable the Drupal module Sub-pathauto and configure the maximum depth of sub-paths to be at least 3.

Q. Why is my object still visible at /islandora/object/PID?

A. Drupal aliases don't negate internal paths like islandora/object/PID. If you want the original islandora URLs to resolve (i.e. redirect) to the aliases, then enable Global Redirect.

Q. Where did the colon in my PID go?

A. By default, Pathauto removes punctuation such as the colon (:) from paths before creating aliases. This will result in PIDs that look like islandora123; if this is undesirable then configure the Pathauto setting under "punctuation" at admin/config/search/path/settings to not remove the colon.

Q. Can I use this module to make the colon to show up as ':' instead of '%3A'?

A. No. Sorry. This happens deep in Drupal's internal link-writing code. See this thread for more information. 

Q. What if I have multiple content models for the same object? Can I give it multiple aliases?

A. No. Multiple aliases for the same object are not supported. All objects should have at most one of their content models enabled for pathauto.


  • No labels