Fix SharePoint Managed Property Not Showing in PnP Search Cards
Question details
Users are unable to display document content or descriptions from a managed property within the PnP Modern Search Profile Card view.
- Product
- Microsoft SharePoint
- Device & OS
- not provided
- Scenario
- Customizing PnP Modern Search results using hitHighlightedSummary or Handlebars data attributes to show specific document properties on search cards.
- Observed behavior
- The managed property content fails to render on the PnP Modern Search cards despite configuring the data attributes.
Ensure you have Site Collection Administrator permissions to verify the Search Schema and managed property settings in the SharePoint Admin Center.
Verify Managed Property and Search Schema Mappings
Ensure the managed property is properly configured to be retrieved and displayed in search results.
For a property to show up in a PnP Search Web Part, it must be mapped correctly in the SharePoint Search Schema and marked as 'Retrievable'.
Navigate to the SharePoint Admin Center, expand 'More features', and click 'Open' under the Search section. Click on 'Manage Search Schema'.
Search for the specific managed property you are trying to display in the PnP Search Cards.
Edit the managed property and ensure the 'Retrievable' checkbox is selected. If it is not retrievable, the search API cannot return its value.
Scroll down to the 'Mappings to crawled properties' section and confirm it is correctly mapped to the crawled property containing your document content.
Customize PnP Modern Search Script and Templates
Modify the PnP script and Handlebars templates to reference the correct result fields.
Seek Assistance in the SharePoint Development Forum
Leverage Microsoft's developer community for advanced script customization and debugging.
Looking for a Simpler Way to Manage Documents? Try WPS Office
While SharePoint configuration and search schema mapping can be highly technical and time-consuming, WPS Office offers a straightforward, lightweight desktop alternative for managing, viewing, and editing your documents effortlessly.
- 1. Download the Installer: Visit the official WPS Office website and click the free download button for your operating system.
- 2. Install the Software: Run the installer file and follow the simple on-screen instructions to complete the setup.
- 3. Open Your Documents: Launch WPS Office to instantly open, edit, and manage your Microsoft Office documents without complex configurations.
Frequently Asked Questions
Why isn't my new managed property appearing in PnP Search results?
A newly created or modified managed property can take anywhere from a few hours to a few days to become available, depending on your SharePoint environment's crawling schedule. Furthermore, ensure the property is explicitly selected in the 'Selected properties' configuration of the PnP Search Web Part.
What is hitHighlightedSummary in SharePoint search?
The hitHighlightedSummary is a default managed property that generates a contextual snippet of document text, highlighting the specific keywords that matched the user's search query.
Can I use crawled properties directly in PnP Handlebars templates?
No. Crawled properties cannot be queried or displayed directly in search results. You must first map the crawled property to a managed property, ensure it is set as 'Retrievable', and then use that managed property in your PnP Search templates.
