You are using an older browser that might negatively affect how this site is displayed. Please update to a modern browser to have a better experience. Sorry for the inconvenience!

URL Rewriting For Site

In Salesforce, the Site provides a built-in logic that helps you to display user friendly URL and links instead of complex URL and links.URL rewriting allows search engines to better index your site pages. Using friendly URLs also allows you to replace the page name and id. For example, the URL can be rewritten with a new URL that is easier to read.

To rewrite URLs for site, create an Apex class that maps the original URL to a user friendly URL and add that Apex class to your site.

Creating the Apex Class

global class yourClass implements Site.UrlRewriter
global pageReference mapRequestUrl (PageReference your FriendlyUrl)
global pageReference [ ]  generateUrlFor (pageReference[ ] yoursalesforceUrls);

To learn more about Site.urlRewriter interface, see Salesforce UrlRewriter Interface

When creating the apex class, you should follow the following guidelines:

1. Class and methods should be a global

2. You should use both method mapRequestUrl() and GenerateUrlFor() . If you don’t need one of the methods, simply specify “return null”.

3. URL rewriting works only with visualforce page. URL rewriting does not work with standard salesforce page, image and other entities.

4. Use !URLFOR function to rewrite your site url page link. To learn more about !URLFOR function, see Salesforce URLFOR Function

URL rewriting with Site

1. From setup, click Develop | Sites

2. Click New.

After the New button is clicked, the below screen will open. Then add the domain path and URL rewriter class. The following screen shots shows these fields.


3. Click Save.

Site Page

<apex:page standardController="contact">
    <apex:pageBlock title="Contact informations.....">
        <apex:outputLink value="{!URLFOR($Page.mycontact,null,  [id=id])}">
    <apex:detail relatedList="false"/>

Apex Class

global with sharing class myRewriter implements Site.UrlRewriter {
// Variable to represent the friendly URLs for Page
   String contact_information = '/mycontact/';
// Variable to represent the custom Visualforce page that displays the page information
   String contact_information_vf_page = '/mycontact?id=';
//The first global method for mapping external URL to an internal one
    global PageReference mapRequestUrl(PageReference myFriendlyUrl){
        String url = myFriendlyUrl.getUrl();

                        String name = url.substring(contact_information.length(), url.length());

            //Select id of the page that maps the name from the URL
            Contact con = [SELECT Id FROM Contact WHERE Name in : name LIMIT 1];
          //construct a new page reference in the form of mycontact visualforce page
            return new PageReference(contact_information_vf_page +;
        return null;
    //The second global method maps the internal ids to URLs
    global List<PageReference> generateUrlFor(List<PageReference> mySalesforceUrls)
  //List of pages to return after all links have been evaluated.
       List<PageReference> myFriendlyUrls = new List<PageReference>();
       List<id> accIds = new List<id>();
      for(PageReference mySalesforceUrl : mySalesforceUrls){
     //get the URL of the page
       String url = mySalesforceUrl.getUrl();
    //if this look like a page that need to be mapped, transform it
//Extract id from the query parameter       
String id= url.substring(contact_information_vf_page.length(),
//Query the name of the contact to put into URL
    List <contact> contacts= [SELECT Name FROM contact WHERE Id IN :accIds];
    Integer counter = 0;
    String a = ((contacts.get(counter).name)+'custom');
     for(PageReference mySalesforceUrl : mySalesforceUrls) {
   // Get the URL of the page.
      String url = mySalesforceUrl.getUrl();
         myFriendlyUrls.add(new PageReference(contact_information + a ));
       } else {
    return myFriendlyUrls;

After completing the above steps, click the Public Access Settings in the Site details page.
Edit the URL Rewriter profile, add the Visualforce page in Enable Visualforce page access section, and add the Apex class into Enable Apex Class access section.
Now, grant Read permission to the object of the records you want to see. In OWD settings, grant Public Read Only access for the object.

Following are the screenshots of URLs without and with URL Rewriting