PnP Modern Search v4¶
The PnP 'Modern Search' solution is a set of SharePoint Online modern Web Parts allowing SharePoint super users, webmasters and developers to create highly flexible and personalized search based experiences in minutes.
Looking for the v3 documentation? Here you go!
PnP Modern Search v3.x deprecation
The v4 version uses a brand new code architecture and replaces the older v3 codebase. There will be no new features added to v3.x, but we will continue to provide bug fixes as needed. Because v4.x is not at feature parity yet with v3.x, you can still use the v3.x packages to meet your requirements. Also, there is not an auto-upgrade path from v3 to v4 due to the new architecture, so you are perfectly ok to stay on the v3 version until v4 provides the features validating your upgrade. However, the main focus is on the v4 version, and new search functionality backed by the Microsoft Graph Search API will be v4 only.
v3 and v4 don't share the same package name, Web Part and solution IDs meaning you can have them side by side on a page if necessary without overlap.
The solution includes the following Web Parts:
|Search Results||Retrieve data from a data source and render them in a specific layout.|
|Search Filters||Filter and refine data displayed in 'Search Results' Web Parts.|
|Search Verticals||Browse data as silos (i.e. tabs) from multiple data sources.|
|Search box||Let users enter free text queries sent to 'Search Results' Web Parts.|
Here is the list of supported browsers:
- Edge Chromium
We don't support Internet Explorer 11. We think there are plenty of other options for enteprise scenarios in the market. Maybe it's time to move on. For developers, it represents an huge ammount of time to make the solution compatible for a very low benefit. Hope you understand, ain't personal ;).
By getting this solution, you also benefit from an advanced extensibility model allowing you to customize the solution according to your requirements if default features don't do the job for you.
The supported extensions are:
- Custom web components.
- Custom suggestions providers.
- Custom Handlebars customization (helpers, partials, etc.).
With these available customizations options, you can do pretty much anything!
Extensibility samples are centralized in a dedicated repository: https://github.com/microsoft-search/pnp-modern-search-extensibility-samples/tree/main. Use them to get started to create your own or reuse existing samples in your projects.
If you encounter an issue, please use the GitHub issues list of this repository. Also, to help us to resolve your issue, you can include screenshots or error messages coming from:
- The faulty Web Part itself.
- Errors displayed in the browser console (typically pressing F12).
- Errors displayed in the SharePoint console (pressing CTRL+F12)
Issues, questions, feedback?¶
For any issue, question or feedback, please the official GitHub repository. We will be happy to help you!
Maintainers & contributors¶
Here is the list of main contributors of the PnP Modern Search (all versions included)