The following guide explains how to filter content displayed in one or more BindTuning web parts using URL parameters. By passing values directly through the page URL, you can create personalized or dynamic views of the same page for users.

Before you begin, this guide is directed to SharePoint Online (Modern experience) users and requires the latest version of the BindTuning web parts installed. This ensures you have access to the most recent features and user experience updates.

Step-by-Step Guide

1. Prepare your data source

For this feature to be available, the web part must be connected to a SharePoint list or document library. Start by making sure your list includes the columns you’ll use to filter content. For example:

Department: values like Sales, Marketing
Country: values like Portugal, Spain

2. Add and configure a Web Part

Go to the page where you want to display filtered content and add the BindTuning web parts that fit your content the best (e.g., Tiles, List, News).
Open the web part settings and under Source, connect it to your SharePoint list.
Click on the ⚙️ next to the list name to “Configure data source.”
Under the Filter section, enable URL Parameters and apply.

3. Build your URL

This is the key step since it defines the filtering rules that will be applied to your page.
If the URL isn’t built correctly, the page will still display content, but the filters won’t be applied as expected. Below are a few guidelines to help you build your own URL.

Base URL
The base URL will vary depending on where your page is located:
- For Home pages
  https://[Tenant].sharepoint.com/sites/[SiteCollection]/?
- For a Site Collection Pages
  https://[Tenant].sharepoint.com/sites/[SiteCollection]/SitePages/[PageName].aspx?
- For Root sites (Home Page)
  https://[Tenant].sharepoint.com/?
- For Root Site Pages
  https://[Tenant].sharepoint.com/SitePages/[PageName].aspx?
- For Hub Sites (Home Page)
  https://[Tenant].sharepoint.com/sites/[HubSiteName]/?
- For Hub Sites Pages
  https://[Tenant].sharepoint.com/sites/[HubSiteName]/SitePages/[PageName].aspx?
- For Subsite (Home Page)
  https://[Tenant].sharepoint.com/sites/[SiteCollection]/Subsite/?
- For Subsite Pages
  https://[Tenant].sharepoint.com/sites/[SiteCollection]/Subsite/SitePages/[PageName].aspx?

BindTuning parameters
These are the parts of the URL that define which content is filtered.
Using the example from Step 1:
- Single filter
  https://[Tenant.sharepoint.com]/sites/[PageName].aspx?btparam_Department=Sales
- Multiple filters (separate them with '&')
  https://[Tenant.sharepoint.com]/sites/[PageName].aspx?btparam_Department=Sales&btparam_country=Portugal
Considerations
Here are a few tips to make the most out of this feature:
- It’s recommended to use the internal name of your SharePoint column. You can find it by going to List settings > Column edit page.
  This is especially important for columns that include spaces or symbols, as Microsoft automatically replaces them with codes like _x0020_ or _x002d_.
- Choices that contain spaces are supported by using %20 to replace the space.
  For example, for Department=Human Resources, the parameter would be btparam_Department=human%20resources.
- Multiple web parts can be connected to different data sources on the same page and still be filtered using the same URL.
  For example:
  - Web Part A (connected to List 1) → Filtered by Department = Sales
  - Web Part B (connected to List 2) → Filtered by Country = Portugal
  Example URL:
  https://[Tenant.sharepoint.com]/sites/[PageName].aspx?btparam_Department=Sales&btparam_Country=Portugal
  Each web part will filter its content based on its own criteria. Web parts without matching parameters will continue to display all their content.

Important: This feature is designed for creating dynamic content experiences. It should not be used for sensitive information, as users can still access the full dataset by manually modifying the URL.

4. Create the user action

Once your URL is ready, you can use it in any call to action — such as a button, link, or tile — to give users access to the filtered page.
The location of the link doesn’t affect how the filtering works, so you can place it wherever it fits best in your layout or navigation.

5. Test the Filtering

To test your setup, simply click the link, button, or tile you created. The page should load with the BindTuning web part showing only the filtered items. You can also adjust the parameters in the URL to try different filter combinations and verify that everything is working as expected.