How to create a serverless URL shortener using Amazon S3

Let’s admit it. We access more and more of the information we need in our daily activities using URLs. These URLs have become longer and more cryptic over time but that’s ok since we simply click on them.

Photo by Steve Johnson on Unsplash

However, sometimes we need to communicate those URLs in a non-internet-native way. For me this has happened during training classes as well as when writing a book. I want the class to download a piece of source code, but the GitHub project file URL is way too long to be correctly retyped by the attendees. Or maybe I want to refer to an online post in the book but printing a very long URL doesn’t make sense.

That’s why we’ve used URL shorteners for quite a while now. Unfortunately, they have their downsides — they may be funded through advertisement sales or offer a freemium version of the product. The features you actually need are diverse; your own domain name, the possibility to customise the URL (instead of being assigned a random string), some come to a surprise to you later on (like the possibility to redirect a shortened URL as the original target has moved).

So why not create your own URL shortener? Now note that I mostly dabble with serverless managed services on AWS for a living so I’m immediately thinking of the following combination:

I could even run the code using Lambda@Edge and then cache the DynamoDB responses for even better performance!

But… even though that would make a great walkthrough on how Lambda and API Gateway work, it seems a bit overkill for just a URL shortener. Is there anything else?

Did you know that S3 can redirect requests? Of course, you did, at least if you’ve used the static website hosting feature of S3 — the option is right there in configuration screen. You might be surprised that instead of redirecting requests to another object in S3 — or another bucket — you can actually enter any other URL as the redirect target. Additionally the object containing the redirection (the short URL) can be of size 0 bytes (meaning you only pay for storage of the metadata).

So how would we create a shortener like this? My example is going to be without any fancy admin UIs etc, we’re going to create and administer the redirects via the AWS CLI only.

First of course you need to create a bucket. You should name your bucket after the website you’re hosting, so in my case that would be

aws s3 mb s3://

Then we need to enable static website hosting, making the default document ‘default’ and the error document ‘error’.

aws s3 website s3:// --index-document default --error-document error

We also need to set proper permissions to the content of the bucket. There are several ways to do this, and my favorite is to create a bucket policy allowing everyone GetObject access to the bucket. First we create the policy document (I use the AWS Policy Generator for this as I’m hopeless when trying to remember syntaxes), I’m saving it to policy.json:

"Id": "Policy1578299737219",
"Version": "2012-10-17",
"Statement": [
"Sid": "Public access to URL shortener bucket",
"Action": [
"Effect": "Allow",
"Resource": "*",
"Principal": "*"

Then we set that JSON file as the bucket policy:

aws s3api put-bucket-policy --bucket --policy file://policy.json

Then we create a DNS record so that requests to our hostname get served by the hosted bucket hostname using Route 53. This is easiest to do via the web console, where we can selected the Hosted Zone we want to edit and then click on “Create Record Set”, edit the name as “links”, leave the type as A and just set Alias to “Yes”. We can then see our bucket in the target options. The routing policy should stay as simple and target health evaluation as “No”.

Now we can create a few redirects, namely the two from above.

aws s3api put-object --bucket --website-redirect-location --key defaultaws s3api put-object --bucket --website-redirect-location --key error

So now we have the default document redirecting to my website and the error document redirecting to a cute 404 image. This can be tested by going to and

Let’s also create a redirect to this blogpost

aws s3api put-object --bucket --website-redirect-location --key s3url

and now it should be available at!

Cloud and AI/ML training and consulting. AWS Champion Authorized Instructor.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store