Step by Step configuration to Add custom Refiners in the Refinement Panel of Search Results page for SharePoint Online


You may have custom Library/List columns created which you would like to show them in the Refinement Panel on the Search Results.

Step 1: Creating a Document
Library / List with Customer Columns

  1. Create a New Document library -> go to Library Settings
  2. Create a new Column “Product Type” – Choice Field is what I selected.
  3. Upload some documents to the library and give different Choice options.


4. Go to Library Settings -> Advanced Settings -> Click on ‘ReIndex Document library’ Button.


Step 2: Creating a New Site
Collection or Sub Site using “Enterprise Search Center” template. (Note: the reason we need to do this is due to the fact that we
cannot modify the OOB ‘osssearchresults.aspx’ page)

I created a Subsite under my site collection using the ‘Enterprise Search Center’ template. Make sure that you are able to search the documents uploaded.


Step 3: Configuring Managed
Properties for Search

  1. Logon to Microsoft Online Portal (MOP)
  2. Go to SharePoint Online Administration Center page.
  3. On the Left Panel -> Select ‘Search
  4. Click Manage Search Schema
  5. Search for Existing Managed property ‘RefineableString00-> Edit the property and set it up as per below. -> Click 'OK'


Note: By Default in SharePoint Online you cannot create a new Managed Property as ‘Refineable’, due to which we need to use the existing ones and give an Alias for that.

 Note: List of Default Existing Refineable Property list.


Step 4:Adding the Managed Property to Refinement Panel on the Search Results Page

  1. Go to the Subsite Search Center site created in Step 2.
  2. Type in any keyword to go to the ‘Results.aspxpage. -> ‘Edit’ that page.
  3. Edit the Refinement Panel web Part. -> Click on ‘Choose Refiners…’ button.
  4. From the list of ‘Available Refiners-> Select ‘RefineableString00-> Click ‘Add’ button.
  5. Change the ‘Display Name’ for it (Initially it may not show the Sample Values, wait for around 5-10 mins to take effect )
  6. Click Ok’ -> Save and Close the Page -> Check-In and Publish the Page


Now when you perform the Search for documents in that library, on left Refinement Panel you will see the new Refiner “Product Type

Comments (20)

  1. Anonymous says:

    Very Good article. When i tried with New Site collection for Enterprise Search center i could not find my columns over there to add to Refiners. Then i tried with a Sub Site with Enterprise Search center i can able to modify the refiners and its working
    like a charm. Keep up the good work.

  2. Rakesh says:

    Gud one Parmi 🙂

  3. dirk says:

    Nice Post, very helpful. I'm trying to set this up by using a managed metadata field as a site column. I struggle to map to the correct managed property. Any tips?

  4. dani says:

    Hi have the same problem as Dirk, did you find the way to fix this?

  5. Divesh says:

    Thanks for the post. I have tried doing the mapping but I am unable to get desired results. Any idea what the problem could be.

    Another thing: I want to show result page with results in a table form with only document sets. My requirement is this:

    I have libraries with document sets and document. I want to show document sets only in result in a table with metadata columns. Can you help?


  6. Mike D says:

    Thanks for Post.

    Just a note that your post spells "RefinableString" with an extra "e" in case people are having trouble searching for using the managed property filter. So "RefinableString00" NOT "RefineableString00".

  7. Mary says:

    How do you know what to put on “Mappings to crawled properties”?

  8. Jeff25 says:

    Finally found the information that I was looking for. The fact that you can’t use custom managed properties as refiners in SharePoint online is a bit of a mystery and a makes me wonder ‘what else can’t I use’ ?

  9. Anonymous says:

    Otra de las posibilidades de personalización que tenemos en las búsquedas es la de añadir más metadatos

  10. ist says:

    Not able to see Refiners on Refiners configuration for Refinement pop-up window after clicking on the CHOOSE Refiners.

  11. ist says:

    Not able to see Refiners on Refiners configuration for Refinement pop-up window after clicking on the CHOOSE Refiners.

  12. Anonymous says:

    Pingback from SharePoint Search | Share your knowledge

  13. Deb says:

    I have this working but can’t get this page to replace the site search page. I even change the site settings at both the admin level and the site level to point to the new search center. No luck, it continues to point to the original site search page.
    Can anyone help? Thank you!

  14. J.Harach says:

    I have just re-indexed my site as I do not see any of my ‘Crawled Properties’. I also do not seem to have any of the reusable ‘Managed Properties’ e.g. RefinableSting00 … what am I doing wrong please help??

  15. Uday Acham says:

    Can we add Managed Properties to Refinement Webart using powershell. Any help would be really appreciated.

  16. MQ says:

    I created a document set library. Added my columns. Shared them. Made sure the managed content was checked yes. It’s checked to be searchable.

    I went to the Schema from my site rather than Central Admin. Found my crawled properties and mapped them to RefineableString01 etc. They’re checked to be refineable, sortable, etc.

    I have waited for a day and still have no sample values. Therefore no refiners. I’ve double checked. The properties are mapped. My site is in the Cloud not on prem. Any help would be appreciated. I unfortunately have a deadline of this Friday.

  17. Manoj Mittal says:

    I have Big Term set category. which is not feasible to show as is in the refinement panel. What i am looking for :-
    Is there any way, so that I can add Manage Metadata Control in the Refinement Panel itself . If i start typing any thing . It will read existing term set and filter the record according .

  18. ekta says:

    Very nice post and easy to follow!!!!!

  19. Anand Kumar says:

    Thanks Mike D for pointing that it’s RefinableString not RefineableString.

Skip to main content