Child pages
  • Home
Skip to end of metadata
Go to start of metadata

Shortened URL Service

Lead(s): Steve Swinsburg

Description: The Shortened URL service for Sakai is a simple service that allows tools and services to shorten links to anything, either via the Java service, or via the Entity Provider.

Institutions can choose how they want the shortened URLs to appear via a setting in - ranging from the built in URL shortener which returns URLs like, to an implementation that uses the URL shortening service: the choice is up to you.

This service is available in Sakai 2.8 and onwards or you can grab it from:
from SVN:
or as a binary:

For institutions

By default, the URL shortener returns the original URL unchanged. So in order to start seeing shorter URLs, you need to configure it in You can choose an implementation from the available list below. Note that the implementation requires extra configuration (documented below):

# Uncomment this to use the built in URL randomiser/shortener (recommended)

# Uncomment this to use the URL shortner

# You must also have a bitly account. So signup, navigate to, retrieve your details, uncomment and set the following:

You can also create your own implementation very easily, see the section Creating your own implementation.

Lastly, by default, the service does not allow you to shorten URLS to anything outside of the Sakai installation using the /direct/url/shorten entity provider. If you need this, and you understand the implications, you can set the following property to true:


Supported tools

  • Resources (SAK-21848) 2.10 onwards. Easily back ported. Activate via:

  • Portal (SAK-21865). 2.10 onwards. Displays a permalink to the tool, can also be shortened, or left as the full URL. Configuration:

    # enables a link icon for each tool in the portal so you can get a direct URL to the tool.
    # in conjunction with the above, if set to true, shows the option to shorten that link.

For developers

There are two ways to use the service in your app, via Spring injection, or via AJAX.

Spring injection

Inject the following API into your application via your Spring wiring, javax.annotation.Resource or use the Sakai ComponentManager:


Now call the shorten(String url) method to shorten the given URL, eg:

String shortUrl = shortenedUrlService.shorten("");

Assuming the RandomisedUrlService is configured, this will produce something like the following:


If you want a more 'secure' URL, use the alternate method to produce a much longer URL (22 chars), shorten(String url, boolean secure), where secure is true.

Assuming the RandomisedUrlService is configured, this will produce something like the following:


Note that this 'secure' method is only implemented in the RandomisedUrlService implementation.


Make a GET request to the following URL:


Note that the URL must be URL encoded. You can also use the 'secure' mode of the RandomisedUrlService by adding the secure URL parameter, e.g:


Creating your own implementation

This is extremely easy. All you need to do is implement a single interface:


At a minimum you should flesh out the shorten(String url) method. You can optionally flesh out the shorten(String url, boolean secure) method if required, otherwise just pass the control back to the first method, ignoring the second parameter.

Then, add some Spring wiring to register it:

<bean id="org.sakaiproject.shortenedurl.api.YOUR_API_NAME"

And finally, in, set your new implementation to be the one used preferentially:


When you restart Sakai, it will be registered as the default and all URL shortening will go through your new implementation. In addition, the EntityProvider will be automatically configured to pick it up, so you can test it straight away in your browser. See the section AJAX.

  • No labels


  1. Even though I am new to Sakai, I was able to get this up and running in no time. Just followed the documentation and it worked!!! Thanks.

    1. Thanks for the feedback Reggie!