From UBC Wiki
Jump to: navigation, search

EZproxy Link Generator

EZproxy Link Generator

Want to create a link to a UBC Library licensed resource for off-campus use? Use our EZproxy Link Generator!

How do I use the EZproxy Link Generator?

Paste the URL into the box below and click "create." This will add the EZproxy prefix to your URL, therefore triggering the system to authenticate users and ensuring the link will work off-campus.

The resulting URL can also be shared with your UBC colleagues and students and embedded into other content, like Canvas and Research Guides.

For best results, we recommend using a persistent URL, or PURL, with the link generator. A PURL is a link to a specific web page that remains stable over time. Many people don't know that some urls are "session-based" and only work for the duration of your search session. If you try to access a session-based url after you log-off, navigate away from the page and/or several hours later you will get an error message instead of the page you were expecting. To learn more, see our guide to Finding Persistent URLs.

If you do not wish to use the link generator tool above, you can paste the following prefix directly in front of your PURL (i.e. no spaces between the prefix and the PURL)

EZproxy Bookmarklet

EZproxy Bookmarklet

The EZproxy Bookmarklet is a great tool if you find yourself often jumping out of an EZproxy session while navigating the web; it's also very useful if you prefer to access e-resources without needing to first visit the Library website (for example, if you are a heavy user of a specific database).

A bookmarklet is a button you can add to your bookmarks bar in whatever browser you are using; once clicked, the bookmarklet uses JavaScript to dynamically rewrite the page you are currently on and add the EZproxy prefix to its URL. If you are already connected, the reloaded page should present you with the content you're looking for; if you're not, you will first be prompted to login and then will be automatically redirected back to your original page.

How do I install the EZproxy Bookmarklet?

Bookmarklet Script/Link/Button?
For Chrome Users

To install the EZproxy Bookmarklet in Chrome, drag the button to your Bookmarks Bar. If your bookmarks bar is hidden, go to the View menu option and select "Always Show Bookmarks Bar." It is recommended that you put the bookmarklet somewhere prominent in the bar (see below image) so it is easy to find and click while researching. You can also edit and rename the bookmarklet.

For Firefox Users

To install the EZproxy Bookmarklet in Firefox, right click on the button and select "Bookmark This Link" to add it to your bookmarks or drag the link to your Bookmarks Toolbar. If your bookmarks toolbar is hidden, go to the View menu option, select "Toolbars" and check "Bookmarks Toolbar." You can also edit and rename the bookmarklet.

For Safari Users

To install the EZproxy Bookmarklet in Safari, drag the button to your Toolbar. If your toolbar is hidden, go to the View menu option and select "Show Toolbar." It is recommended that you put the bookmarklet somewhere prominent in the bar (see below image) so it is easy to find and click while researching. You can also edit and rename the bookmarklet.

For Internet Explorer Users

To install the EZproxy Bookmarklet in Internet Explorer, right click on the button and select "Add to Favorites..." from the menu. If a dialogue box asks you if you'd like to continue, click 'Yes.' In the 'Add a Favorite' options, choose the 'Create In' drop-down menu and select 'Favorites Toolbar. You can also rename the bookmarklet here if you want to. Click Add.

For iPad Users

To install the EZproxy Bookmarklet on an iPad, in Safari save this page as a bookmark, then edit the bookmark to rename it to something more descriptive about it being a bookmarklet for EZproxy, and paste the following JavaScript into the URL field:


How do I use the EZproxy Bookmarklet?

Whenever you are unable to access an e-resource from a website or database or prompted to pay for an article, click on the EZproxy Bookmarklet.


The page should then reload via EZproxy, providing you with access.


Known Problems

In order for the EZproxy Bookmarklet to work, you must have JavaScript enabled in your browser.

If you do and are still unable to gain access to a electronic resource, it could be because EZproxy attempted to automatically reload a URL for a page, such as a vendor website error page or a publisher database login page, that does not belong to a resource (i.e. is not actually the page where the article or chapter is hosted). Trying to proxy such a page will therefore not produce the desired result (a link to a resource or full-text download) and instead will redirect you to the following error page:


In these cases, you may be able to access the resource by using your browser's Back button to navigate before a point where you encountered the vendor or publisher landing page (for example, the link to the resource from Google Scholar). Clicking on the link again should then provide you with direct access.

This error page will also occur when attempting to proxy any non-academic resource website, whether it be Google, UBC's homepage, Wikipedia, or Facebook.

You may also receive this error message if UBC Library does not have licensed access to a particular resource or has not added the resource to its EZproxy config file. If you receive an error message and are denied access to an academic resource that you think the Library may have a license for, please contact the Library's Technical Services Department via the Electronic Resources: Questions and Comments form.

UBC LibX Toolbar


LibX is a browser tool which works much like the EZproxy bookmarklet with one notable difference: the bookmarklet is intended only for pages that you're already on and reloads the current URL via EZproxy; LibX, on the other hand, can also activate EZproxy to rewrite new links just prior to clicking on them. This functionality is especially useful for avoiding the bookmarklet error message page described above as proxied access is provided before arriving on the vendor and publisher sites, so that sites can identify that you are licensed for access and therefore won't redirect you to a generic landing page or login screen.

LibX was developed by the University Libraries and the Department of Computer Science at Virginia Tech and is available for academic libraries to use under the Mozilla Public License for free software. While the toolbar offers a range of functionality, the UBC Library edition of LibX focuses exclusively on providing support for proxying e-resources for off-campus access.

How do I install LibX?

The UBC Library edition was developed with LibX release version 2.0 . Currently, UBC'c LibX is only available for Chrome.

For Chrome Users

To install the EZproxy Bookmarklet in Chrome, click here. You will be taken to a new page with a button for adding UBC LibX 2.0 to Chrome.

Chrome button.png

After clicking on the button, a pop-up window will appear you asking you to confirm that you want to install LibX as a browser extension. If you are ok with adding the extension, click Add. For more information on LibX Privacy Policy, please see the LibX Settings section.

Chrome pop-up.png

A new pop-up window will appear in the top right-hand corner of your browser notifying you that you have added the extension successfully. An icon for LibX (a blue UBC image) will also appear in your browser.

Chrome added.png

Clicking on the UBC icon will give you access to the drop-down LibX toolbar.

Chrome toolbar.png

How do I use LibX?

You can use LibX in one of two ways:

1. As a drop-down toolbar from your browser, featuring a search box for the UBC Library Catalogue, Google Scholar, the UBC Journal Collection, and Summon and links to popular content on the UBC Library website; and

2. As a right-click context menu within webpages.

You can access EZproxy support with both of these options; it's up to you to decide how you want to use LibX!

To active EZproxy when in the toolbar, click on the Proxies tab in the left sidebar navigation menu and, under EZproxy, select "Reload page with this proxy."

To activate EZproxy with the context menu, right-click anywhere on a page and choose the option "Reload page via EZproxy."

For Chrome Users

To proxy a link to a new page when using Chrome, right-click on the link, mouse over "LibX for Google Chrome (TM)", then select "Follow link via EZproxy."

Chrome right click.png


You can customize your LibX options, enable or disable functionality, and specify your display preferences by first clicking on the UBC icon in your browser to activate the drop-down toolbar and then choosing "Preferences" from the left sidebar menu (this will open a new tab in your browser).

Context Menu

Visit the Context Menu tab under Preferences to add even more options to your right-click context menu (in addition to the default options to reload or follow a link via EZproxy). Check off the boxes to include the ability to search keywords, titles, and authors in Summon or the UBC Library Catalogue all by using the context menu.


According to LibX Privacy Policy, use of the extension will send the URL of pages you are currently visiting to UBC Library's catalogue server and EZproxy server.

The LibX Project and its developers are also using Google Analytics to learn how LibX is being used across the different academic libraries that provide their patrons with an edition. Type of data collected includes such things as how many times a library catalogue search is performed using the toolbar (according to the LibX Privacy Policy, only the event is logged, not the actual search query).

To disable Google Analytics from tracking your usage, visit the Browser tab under Preferences and uncheck the following options:

  • Send extension usage (e.g edition installed, catalogs used for searches) [Note: LibX uses Google Analytics]
  • Send libapp usage (e.g frequently used libapps) [Note: LibX uses Google Analytics]

Known Problems

While using LibX is a good bet for avoiding the vendor and publisher website difficulties encountered with the EZproxy bookmarklet, the same error page will still occur if you attempt to proxy any non-academic resource websites or any resources that have not been added to the EZproxy config file by UBC Library.

Other Tools Available

The Link Generator, Bookmarklet, and LibX are all tools that provide enhanced support and easier access to e-resources for off-campus users. Other tools may be available, but are not supported by UBC Library. They may also not be as comprehensive in scope and cover all of UBC Library's resources. Some of these options include:


Those who use Zotero may be happy to learn that the popular citation management tool also provides some support for EZproxy to users of the Firefox extension. To configure Zotero to work with EZproxy, users must add the proxy address under the Proxies tab in Preferences (for more information, see the relevant Zotero documentation).


Make sure to check off both the 'Enable proxy redirection' and 'Automatically recognize proxied resources' options. To add EZproxy access for UBC Library, click on the plus sign, check 'Multi-site' then enter the following into the scheme field:

Please note that only resources that the user has previously visited while proxied will be recognized by the Zotero proxy tool (resulting in automatic access or a redirection to UBC Library's EZproxy login page). This is because the tool learns from a user's activity - therefore, the more resources you visit while proxied, the more resources Zotero will save and remember for the future.


The Mendeley website also offers some support for EZproxy access for searches in its crowd-sourced research catalog. To configure EZproxy access in Mendeley for UBC Library, log into the site, click on the Papers tab, and then search for a paper or click on any of those listed as popular. On the paper's overview page, click the 'Find this paper at:' button and select 'Edit library access links.'


Choose 'Add library manually,' and then enter UBC Library for name and the following for base URL:


From now on, clicking on 'Find this paper at' will give you the option of searching in UBC Library and should connect you directly to our holdings.


Papers App

Papers, a citation management application that can sync up your collection of references and PDFs across your desktop, laptop, and iPhone, iPad, or iPod touch, can also be configured so that electronic resources are automatically prepended with UBC Library's EZproxy prefix. Please note that Papers is not supported by UBC Library.
To configure EZproxy for iPhones, iPads, or iPods, you must first manually add the following prefix to the Papers application under "Proxy Settings" in the Settings menu:

Make sure to toggle the "Use EZProxy" option to "On."

For desktop or laptop usage, you need only to select the University of British Columbia as your Library Proxy from a drop-down list of universities—how you do this will depend on the OS (Windows or Mac) you are using. For Windows, the option is available under Access -> Options. For Mac, go to Preferences -> Access. Please see below for an example of how to add UBC Library to Papers for Mac:

In the application menu, navigate to Papers and select "Preferences..."


Click on the "Access" tab. If you have not yet configured EZproxy, you should see the message "No proxy selected" in the "Use Library Proxy" field.


Click on the drop-down menu and scroll through the options until you find "University of British Columbia."


Select and close the menu. (We recommend leaving the Library website URL field empty)

EZproxy Redirect

EZproxy Redirect is a browser extension (similar to LibX) but available only to Chrome users. To install, click here. Please note that EZproxy Redirect requires that you add UBC as your school (the default for the extension is set to serve Drexel University Libraries). To do this, right-click the extension icon and select "Options." Under "Select School," choose the University of British Columbia and hit Save.

EZproxy Greasemonkey Script

Based on the UCalgary EZproxy Redirector created by David Aikema, this script first requires an installation of the Greasemonkey extension for Firefox. After clicking on this UCalgary EZproxy Redirector link (also found here in #2) and agreeing to install the script, you must then also edit and update the script to add in UBC Library's EZproxy prefix. To do this, click on "Tools" in Firefox, select Greasemonkey and then "Manage User Scripts." In Preferences, click on "Edit this User Script" and replace all references to "" with ""