Skip to content

PURL Server

Callie edited this page May 11, 2026 · 1 revision

The PURL server was created so that we can have a way to create persistent links to items in Collective Access and Kaltura, primarily. Before you use the PURL server, you will need to create an account through the interface. Someone from Libraries IT (currently, Michael Allen) will approve your account.

PURL Server: https://purl.libs.uga.edu/purl_admin/

There are three options after you log in: Rules, ID Lookups, and URL replacements.

Rules

  • You are unlikely to need to create a new rule. These are the patterns that the PURL server uses to create the persistent link in the background. You will need to know the name or "key" of the rule that you're using to create a new PURL.
  • bmac - This is the rule for creating PURLs that link to an item page in CA.
  • bmac-coll - This is the rule for creating PURLS that link to a collection level record in CA (one of the most commonly used rules).
  • audio/video - Use these rules to link to items in Kaltura
  • ohms - Used for linking to OHMS indexes.

ID Lookups

  • This is the most commonly used section of the PURL server. This is where you give the PURL server the information it needs to translate a direct CA or Kaltura link into a persistent, predictable PURL.
  • To add an ID Lookup:
    1. Click Add ID Lookup
    2. Key : enter one of the keys (e.g. bmac, or bmac-coll)
    3. Library ID: This is the bit of unique code from the CA or Kaltura website.
      • For CA, it's the usually 5 or 6 digit number in a CA link
        https://ca.libs.uga.edu/index.php/editor/objects/ObjectEditor/Edit/object_id/40299 --> 40299 in this example
    4. Replacement ID: This is what you want to show in the PURL
      • For items in CA, use the uniqueID, eg. hm-capp_0001, wsb-video_fm03456
      • For collections in CA, use the collection ID, eg. gacenter, jostew, wsb-video
    5. Click Save, and the new PURL is now live.

Using a PURL

  • After a lookup has been added, all you need to do to use the PURL is put the Replacement ID into the Rule pattern.
    • If you forget what these are, go to View Rules, then click on Show next to a particular Rule, and look at what is written in the PURL field.
  • For CA Items: http://purl.libs.uga.edu/brown/[REPLACEMENT ID]/bmac
    ex. http://purl.libs.uga.edu/brown/hm-sallen_0001/bmac
  • For CA Collecions: http://purl.libs.uga.edu/brown/[REPLACEMENT ID]/bmac-coll
    ex. http://purl.libs.uga.edu/brown/gacenter/bmac-coll

Not sure if a PURL has been created already?

  • You can check to see if a PURL lookup has already been created by clicking View ID Lookups. From that page, you can use the search box in the upper right to check on specific item or collection IDs.

Clone this wiki locally