Skip to content
  • There are no suggestions because the search field is empty.

How do you configure the PnP Search Results component in Involv intranet?

Set up and customise the PnP Search Results component to display search results from Involv Search with tailored queries, layouts, and behaviour.

1. Overview

The PnP Search Results component displays search results from connected data sources inside your Involv intranet. After you add the Involv Library to PnP Search, you configure the component to control which data it queries, how it looks, and how it connects to other search components on the page.

With PnP Search Results you can connect to Involv Search, define queries and filters, apply Involv templates and layouts, use paging, caching, and the AI Assistant, and control when and where the component appears.

The configuration is spread across four pages in the properties panel. This article walks through each page in order.

2. What you'll learn

  • How to configure the data source, query, and default behaviour (Page 1/4)
  • How to choose layouts, templates, and selection options (Page 2/4)
  • How to connect the component to other PnP Search components (Page 3/4)
  • How to extend functionality with the Involv Library, audience targeting, and import/export (Page 4/4)
  • When to use predefined search queries instead of custom query strings

3. Before you start

Before configuring the component, make sure you have added the Involv Library to PnP Search. Without it, many Involv-specific options will not be available. See How to add Involv library to PNP Search?.

4. Page 1/4 — Data source, query, and default behaviour

Layout slots

Click Edit layout slots for this data source to customise how data maps to the template. Layout slots are pre-configured by Involv and usually don't need changes.

Search query (5.3.1)

The Search query section gives you two ways to define the query:

Select a predefined query or enter a custom search template (use {searchTerms} for user input)

Option 1 — Quick Select (recommended)

Pick a ready-made query from the Quick Select dropdown. Involv 5.3.1 ships these predefined queries:

  • Search Terms
  • News, Events, Jobs, FAQs
  • Involv Hires (From list)
  • Recent hires
  • Upcoming birthdays
  • My documents
  • Upcoming events
  • Event
  • News
  • News carousel
  • Hero
  • Jobs
  • FAQ
  • Sites
  • Who is who
  • Company anniversaries
  • Involv Hires

When you pick one, the Query Template field fills in automatically (for example, choosing News fills in InvolvCategoryOWSCHCS:News).

Option 2 — Custom Query Template

Type your own query in the Query Template field. Use:

  • {searchTerms} — placeholder for direct user input (for example via URL parameter)
  • {inputQueryText} — placeholder for input coming from another connected PnP component on the same page, like a PnP Search Box

Apply

Click Apply to activate your selection or custom template. Changes only take effect once Apply is clicked.

Source ID

Select a built-in source ID or enter a custom GUID. Default: Local SharePoint results.

Selected properties

Select managed properties to retrieve from search results. Leave empty to use template slot fields. By default, Title is selected, with 54 additional properties available.

Other Page 1 settings
  • Trim duplicates (default: Off)
  • Sort settings — click Edit sort settings to define the order of results
  • Use query string (default: Off)
  • Query string — default parameter is q (optional)
  • Categorization (default: Off)
  • Personal categories (default: Off)
  • Show subscribed content (default: Off)
  • Use target audience (default: Off)
  • Use multilingual (default: On)
  • Use synonyms (default: Off)
  • Enable query rules (default: Off)
  • Randomize (default: Off)
  • Enable Multi Geo (default: Off)
  • Temp Sorting direction — On (ascending) or Off (descending, default)
Involv Caching

ℹ️ To enable caching, you need to make use of the Caching refiner in the PnP Filters web part.

  • Enable dynamic caching (default: Off)
  • Cache expiration (minutes) — default: 5
Involv AI Assistant
  • Enable AI Assistant (default: Off)
  • AI Model Name — default: gpt-4o
  • AI Search Type — specify people or pages
  • People Search Prompt
  • Pages Search Prompt
  • Summary Prompt — prompt for AI when generating summaries

See How to enable AI assistant in PnP search results? for full AI configuration.

Paging options
  • Show paging (default: On)
  • Number of items per page
  • Number of pages to display in range (default: 5)
  • Hide navigation buttons (prev/next) (default: Off)
  • Hide first/last navigation buttons (default: Off)
  • Hide navigation buttons if disabled (default: Off)
Visibility
  • Show in mobile and email view (default: On)

5. Page 2/4 — Layouts, templates, and selection

Available layouts

Choose from the built-in templates or use Custom to write your own Handlebars/HTML.

General-purpose: Details List, Cards, Slider, List, Debug, Custom, People

Image-based: Small image on the left, Hero Template, Large Images, List With Preview Image

Carousel: Carousel, Carousel Full Width, Carousel With Template Options

Content-type specific:

  • News With Template Options
  • Events, Events With Template Options, Events Timeline
  • Recent Hires
  • FAQ, FAQ Accordion
  • Documents With Roll Up View, Documents With Card View
  • Jobs With Background
Edit results template

The Edit results template field shows a preview of the Handlebars/HTML. Click to open the full editor and customise the layout markup.

Result Types

Click Edit result types to define per-type rendering logic.

Selection options
  • Allow items selection (default: Off) — enable selecting individual result items
  • Use Microsoft Graph Toolkit (default: Off)

When Allow items selection is turned on, two extra toggles appear:

  • Allow multiple selection (default: Off)
  • Preserve selection on empty click (default: Off)
SharePoint Agents for Microsoft Copilot (5.3.1)

On compatible Documents-type templates (Documents With Card View or Documents With Roll Up View), when you enable Allow items selection together with Allow multiple selection, a new toggle becomes available: Enable SP Agents for Copilot.

This lets end users with a Microsoft Copilot licence chat with Copilot about the items they select in the results. For the full configuration, prerequisites, and end-user flow, see [How do you enable SharePoint Agents for Microsoft Copilot in PnP Search results?](placeholder — new 5.3.1 article).

Common
  • Hide this web part if there's nothing to show (default: Off)
  • Show results count (default: On)
  • Show selected filters (default: Off)
Styling Options
  • Results Background Color
  • Results Border Color
  • Results Border Thickness (default: 0)
Web part title styling
  • Title font (default: Segoe UI)
  • Title font size (px) (default: 16)
  • Title font color
Layout options
  • Open in new tab (default: Off)
  • Show categories (default: On)
  • Categories are filterable (default: Off)
  • Show description (default: Off)
  • Show extra fields (text field)
  • Show likes & comments (default: On)
  • Show date (default: On)
  • Show mandatory read icon (default: On)
  • Show pinned icon (default: On)
  • Override URL (text field)
  • Show all (default: Off)

6. Page 3/4 — Connections to other components

Page 3 lets you connect this PnP Search Results component to other search components on the same page.

Use input query text
  • Static value — use a fixed query string
  • Dynamic value — use input from another component on the page

When using Dynamic value:

  • Connect to source — select the source component (for example PnP - Search Box)
  • [Source]'s properties — choose which property of that source to read from (for example Search query of a PnP Search Box)
  • Use a default value — fall back if no dynamic input is available
  • Default value — the fallback string to use
Connect to a filters Web Part (default: Off)

When turned on, select Use filters from this component to link to a Search Filters Web Part on the page.

Connect to a verticals Web Part (default: Off)

When turned on, select a verticals component on the page to filter results by search vertical.

Connect to a search results Web Part (default: Off)

When turned on, connect to another PnP Search Results component on the page.

7. Page 4/4 — About, extensibility, audience targeting, and import/export

About
  • Author(s) — credits to the open-source maintainers (Franck Cornu, Mikael Svenson)
  • Version — the installed PnP Modern Search version (for example, 4.19.1)
  • Web Part instance ID — the unique GUID of this specific component instance on the page
Resources
  • Documentation — link to the official PnP Modern Search documentation.
Extensibility configuration

Click Configure next to Extensibility libraries to load to open the library management panel. This is where you connect the Involv Library:

  • Name: Involv
  • Manifest GUID: 6ea3e6dc-eb0c-4157-aff3-46d29188ccfe

Without the Involv Library, many Involv-specific options — predefined queries, AI Assistant, and SP Agents for Copilot — will not function.

Audience Targeting

Restrict who sees this component based on Microsoft 365 audience membership:

  • Target Audience — enter one or more audience names
  • Cache duration (hours) (default: 24) — duration in hours to cache the audience membership information
Import/Export settings

Click Edit properties to open the JSON import/export panel. Export your current configuration as JSON and re-import it on another page to duplicate a fully configured search experience.

8. Result

You now have a fully configured PnP Search Results component showing results from Involv Search with the queries, layout, filters, paging, and connections that match your use case. If you enabled Copilot SP Agents on a compatible Documents template, end users with a Copilot licence can chat with Copilot about their selected results.

Related articles:

Involv version 5.3