Skip to main content
How to Create Vanity URLs in AEM

A Comprehensive Guide on how to Create Vanity URL in AEM

Vanity URLs in AEM

It’s important to have a short and meaningful URL structure for easy readability and SEO optimization. As an author or a developer, it would be confusing to generate vanity URLs in AEM. In this article, we would be seeing steps to generate vanity URLs.

Before we proceed on how to generate vanity URLs, lets first try to understand what Vanity URL is.

What is Vanity URL?

In simple terms, Vanity URL is a meaningful short form of the long URL.

Long URL:

Vanity URL:

What are the Advantages of using Vanity URLs?

Following are the 4 benefits of using Vanity URLs:

  • Easy to remember and pronounce.
  • Improves SEO: When vanity URLs are used appropriately, it can be a good marketing gold. Choose vanity URLs that compliments your existing marketing and SEO strategy.
  • Increase/create the brand awareness.
  • Build trust with the audience.

Now, let’s see how we create vanity URLs in AEM.

Steps to create Vanity URLs:

  • Open any page in author instance that you want to create Vanity URL. In this article, I am taking an example of we-retail.


steps to create aem vanity url
  • Open Page properties and navigate down to Vanity URL section.
comprehensive guide to create vanity url
  • Click on Add and add the vanity URL. Then, click on Save and Close. Behind the scenes, vanity URLs are stored in the property of sling: vanityPath. You can add multiple vanity URLs to the same page.
comprehensive guide to create vanity url
how to create vanity url
  • If you are adding multiple vanity URLs to the same page, then the values will be stored in the form of an array.
vanity url in AEM
  • Now, publish the page to test the vanity url.
steps to create aem vanity url
  • After publishing the changes, you can access the original page using the vanity URL.
    • I.e., http://localhost:4503/analog-dark-wash-jean.html


  • Don’t use the same vanity URL for different pages.
  • Vanity URLs are case sensitive.
  • You don’t need to add a/at the start of the vanity URL.
  • If you are adding multiple vanity URLs to the same page, then the rank of that page gets decreased as link popularity is divided between URLs and the same page competes against itself.
  • To overcome this problem, one of the good ways is to configure Redirect 301 and redirect the user to original page.
  • To add Redirect 301, you just need to select the checkbox in the vanity URL section in the page properties of that page.
comprehensive guide to create vanity url
  • Publish the page after selecting ‘Redirect Vanity URL’. After publishing the page, when you try to access http://localhost:4503/analog-dark-wash-jean.html, it would redirect you to the actual link I.e., http://localhost:4503/content/we-retail/us/en/products/men/pants/analog-dark-wash-jean.html#meotsuann-28.

However, there are a few limitations with vanity URLs. Vanity URLs don’t directly work with dispatcher. That being said, if an author creates a vanity URL and publish the page, still it won’t be available without updates from the webserver and a server restart. Unfortunately, this can be a challenging task because it entails a continuous update of the configuration files and a restart of the web server every time. In our next blog, we will see how dispatcher work continuously with AEM to get the list of vanity URLs from AEM

Our Locations