If you need a SharePoint knowledge base where people find how-to answers without emailing IT, you don’t need a special add-on. Use the Site Pages library: one page per article, a category column, a grouped view, and a landing page that shows it.
Here’s where most people get stuck. They go looking for a “wiki” template, or they upload Word files into a folder tree. Both end up hard to browse and hard to keep current.
In this tutorial, we’ll build a SharePoint knowledge base step by step in the browser, then build the same thing with PnP PowerShell, and finally look at other options Microsoft documents.
I built everything here on 10/25/2026 in our SPGuides Intranet site, so the labels match what you’ll see today.
The sample knowledge base we’ll use
Everything lives on a communication site called SPGuides Intranet, the same site from my guide to building a SharePoint intranet. Here’s what the finished knowledge base holds:
| Article (page title) | KB Category |
|---|---|
| How to reset your Microsoft 365 password | IT |
| How to connect to the SPGuides VPN | IT |
| How to set up Outlook on your phone | IT (added later with PowerShell) |
| How to request time off | HR |
| How to book a meeting room | Facilities |
Each article is a short page: one intro sentence, a numbered “Steps” list, and sometimes a “Common problems” or “Still stuck?” section. Short and predictable is what makes a knowledge base easy to scan.
Not sure which words mean what? Keep my SharePoint glossary open while you build.
Method 1: Build It With Site Pages and a Category Column (Recommended)
Use this when you want a no-code knowledge base that any site owner can maintain. It takes about 20 minutes for the first version.
Step 1: Add a KB Category choice column
- Go to Settings > Site contents and open Site Pages.
- Select + Add column to the right of the last column.
- In Create a column, pick Choice and select Next.
- Name it KB Category, type the choices IT, HR and Facilities, and select Save.

The pane listed Text, Choice, Date and time, Multiple lines of text, Person, Number, Yes/No and more. For other choice settings, see my post on a choice column with fill-in options.
How does this work?
Every column you add to Site Pages also shows up in each page’s Page details pane. So authors can tag an article right from the page: Edit > gear icon > Properties.
Microsoft notes you need owner or designer permission to change page properties. Members who only edit content may not see that option.
Step 2: Write the articles as pages
- On the site home page, select + New > Page.
- Pick the Blank template and select Create page.
- Type the title in Add a title, such as How to connect to the SPGuides VPN.
- Add a Text web part with the intro and the numbered steps.
- Select Publish.
Here’s our VPN article after publishing:

Then open Page details and set KB Category to IT. Republish so the change sticks.
Pro Tip: Start every title with “How to”. It reads like the question people type, and it sorts the articles neatly inside each category.
Step 3: Create a grouped Knowledge Base view
Back in Site Pages, add a view that shows only tagged pages, grouped by category. The steps are the same as any SharePoint list view:
- Open the view menu and select Create new view. Name it Knowledge Base.
- Show Name, Title, KB Category and Modified.
- Filter so KB Category is not empty, and sort by Title.
- Group by KB Category and save the view.

The view showed KB Category: Facilities (1), KB Category: HR (1), and KB Category: IT (2). The site’s home page and other untagged pages dropped out.
How does this work?
The filter does the cleanup. Site Pages holds every page on the site, so without it, the home page and news posts would mix in with the articles.
Step 4: Build the landing page
- Create a new page titled SPGuides Knowledge Base.
- Add a Text web part: “Find answers to everyday IT, HR and Facilities questions. Pick a category below or use the search box at the top of the site.”
- Select + and add the Document library web part.
- Pick Site Pages, then in Edit properties set View to Knowledge Base.
- Select Publish, and add the page to the site navigation.

The web part header shows Site Pages, See all, and the Knowledge Base view picker. Each article title opens the page.
For something more visual on the same page, add Quick links for your top five articles above the list.
Step 5: Check that search finds your articles
Search works out of the box, so there’s nothing to set up. I typed VPN in the site search box about five minutes after publishing:

The VPN article came back first, scoped to SPGuides Intranet, with tabs for All, Files, Sites, News and Images. That’s why clear titles matter so much.
Method 2: Build the Knowledge Base With PnP PowerShell
Use this when you need the same knowledge base on several sites, or you want to load dozens of articles at once. You need PnP.PowerShell and your own Entra app; my guide to connecting to SharePoint Online with PowerShell covers the setup.
Here’s the script that built the column, four articles and the view:
$env:PNPPOWERSHELL_UPDATECHECK='Off'
Connect-PnPOnline -Url "https://spguides.sharepoint.com/sites/SPGuidesIntranet" -ClientId "<your-client-id>" -DeviceLogin -PersistLogin
# 1. Category column on Site Pages
if (-not (Get-PnPField -List "Site Pages" -Identity "KBCategory" -ErrorAction SilentlyContinue)) {
Add-PnPField -List "Site Pages" -DisplayName "KB Category" -InternalName "KBCategory" -Type Choice `
-Choices "IT","HR","Facilities" | Out-Null
}
# 2. Articles
$articles = @(
@{ Name="KB-Reset-your-password"; Title="How to reset your Microsoft 365 password"; Cat="IT"; Html=@"
<p>Use this when you forget your password or it expires. It takes about two minutes.</p>
<h2>Steps</h2>
<ol><li>Go to the Microsoft 365 sign-in page and select <strong>Forgot my password</strong>.</li>
<li>Enter your SPGuides work email and complete the verification code step.</li>
<li>Type a new password (at least 12 characters) and sign in again.</li></ol>
<h2>Still stuck?</h2><p>Create a ticket in the Service Requests list and pick the category <strong>Password reset</strong>.</p>
"@ },
@{ Name="KB-Connect-to-the-VPN"; Title="How to connect to the SPGuides VPN"; Cat="IT"; Html=@"
<p>You need the VPN to reach file shares and internal apps from home.</p>
<h2>Steps</h2>
<ol><li>Open the <strong>Global VPN</strong> app from the Start menu.</li>
<li>Select the <strong>SPGuides-Main</strong> connection and select <strong>Connect</strong>.</li>
<li>Approve the sign-in request in Microsoft Authenticator.</li></ol>
<h2>Common problems</h2><p>If it keeps disconnecting, restart your router and try a wired connection.</p>
"@ },
@{ Name="KB-Request-time-off"; Title="How to request time off"; Cat="HR"; Html=@"
<p>All paid time off is requested in the HR portal at least two weeks ahead.</p>
<h2>Steps</h2>
<ol><li>Open the HR portal and select <strong>Time off</strong>.</li>
<li>Pick the dates and the type (vacation, sick, personal).</li>
<li>Submit. Your manager gets an approval email.</li></ol>
"@ },
@{ Name="KB-Book-a-meeting-room"; Title="How to book a meeting room"; Cat="Facilities"; Html=@"
<p>Every meeting room in the office has its own room mailbox, so you book it from Outlook.</p>
<h2>Steps</h2>
<ol><li>Create a new meeting in Outlook.</li>
<li>Select <strong>Room Finder</strong> and choose the building and floor.</li>
<li>Add a free room and send the invite.</li></ol>
"@ }
)
foreach ($a in $articles) {
$page = Get-PnPPage -Identity "$($a.Name).aspx" -ErrorAction SilentlyContinue
if (-not $page) {
$page = Add-PnPPage -Name $a.Name -Title $a.Title -LayoutType Article
Add-PnPPageTextPart -Page $page -Text $a.Html | Out-Null
$page.Publish() | Out-Null
$page = Get-PnPPage -Identity "$($a.Name).aspx"
}
Set-PnPListItem -List "Site Pages" -Identity $page.PageListItem.Id -Values @{ KBCategory = $a.Cat } -UpdateType SystemUpdate | Out-Null
"Article: $($a.Title) [$($a.Cat)]"
}
# 3. Knowledge Base view: only KB pages, grouped by category
if (-not (Get-PnPView -List "Site Pages" -Identity "Knowledge Base" -ErrorAction SilentlyContinue)) {
Add-PnPView -List "Site Pages" -Title "Knowledge Base" -Fields "DocIcon","LinkFilename","Title","KBCategory","Modified" `
-Query '<GroupBy Collapse="FALSE"><FieldRef Name="KBCategory" /></GroupBy><OrderBy><FieldRef Name="Title" /></OrderBy><Where><IsNotNull><FieldRef Name="KBCategory" /></IsNotNull></Where>' | Out-Null
}
"View ready"
It printed one Article: line per page and then View ready. The checks make it safe to run twice.
This second part creates the landing page with the Document library web part pointed at our view:
$list = Get-PnPList -Identity "Site Pages"
$view = Get-PnPView -List "Site Pages" -Identity "Knowledge Base"
$page = Get-PnPPage -Identity "Knowledge-Base.aspx" -ErrorAction SilentlyContinue
if (-not $page) {
$page = Add-PnPPage -Name "Knowledge-Base" -Title "SPGuides Knowledge Base" -LayoutType Article
Add-PnPPageSection -Page $page -SectionTemplate OneColumn | Out-Null
Add-PnPPageTextPart -Page $page -Section 1 -Column 1 -Text "<p>Find answers to everyday IT, HR and Facilities questions. Pick a category below or use the search box at the top of the site.</p>" | Out-Null
Add-PnPPageWebPart -Page $page -Section 1 -Column 1 -DefaultWebPartType List -WebPartProperties @{
isDocumentLibrary = $true; selectedListId = $list.Id.ToString(); selectedViewId = $view.Id.ToString(); listTitle = "Site Pages"; webpartHeightKey = 4
} | Out-Null
$page.Publish() | Out-Null
}
"Page: " + (Get-PnPPage -Identity "Knowledge-Base.aspx").PageTitle
It printed Page: SPGuides Knowledge Base, and the published page matched the one from Method 1.
How does this work?
Add-PnPField creates the KB Category choice column. Add-PnPPage with -LayoutType Article creates each page, and Set-PnPListItem tags it after publishing.
Add-PnPView builds the grouped view from a CAML query: group by KBCategory, sort by Title, and keep only items where KBCategory isn’t null.
Adding articles later is the best part. This run added a fifth article and listed the whole knowledge base:
Connect-PnPOnline -Url "https://spguides.sharepoint.com/sites/SPGuidesIntranet" -ClientId "<your-client-id>" -DeviceLogin -PersistLogin
# Add a new knowledge base article and tag it
$page = Add-PnPPage -Name "KB-Set-up-Outlook-on-your-phone" -Title "How to set up Outlook on your phone" -LayoutType Article
Add-PnPPageTextPart -Page $page -Text "<p>Install Outlook from the App Store or Google Play and sign in with your work email.</p>" | Out-Null
$page.Publish()
$item = (Get-PnPPage -Identity "KB-Set-up-Outlook-on-your-phone.aspx").PageListItem
Set-PnPListItem -List "Site Pages" -Identity $item.Id -Values @{ KBCategory = "IT" } | Out-Null
# Every article, grouped by category
Get-PnPListItem -List "Site Pages" -Fields Title, KBCategory |
Where-Object { $_["KBCategory"] } |
Sort-Object { $_["KBCategory"] }, { $_["Title"] } |
Format-Table @{n="Category";e={$_["KBCategory"]}}, @{n="Article";e={$_["Title"]}} -AutoSize

The table came back sorted by category:
Category Article
-------- -------
Facilities How to book a meeting room
HR How to request time off
IT How to connect to the SPGuides VPN
IT How to reset your Microsoft 365 password
IT How to set up Outlook on your phone
If Connect-PnPOnline isn’t found, fix that first with this Connect-PnPOnline guide. More scripts like this are in my PnP PowerShell scripts collection.
Pro Tip: Keep article bodies in a CSV or separate HTML files once you pass ten articles. The script stays short, and writers can edit content without touching PowerShell.
Method 3: Other Ways to Show Knowledge Base Content
I didn’t build these for this post, so this is what Microsoft’s docs say, not test results.
- Highlighted content web part: it can pull from “The page library on this site” and filter by a managed property. Layouts include Cards, List, Carousel, Compact and Filmstrip. See my Highlighted content web part tutorial.
- Page properties web part: shows chosen columns, like KB Category, on the article itself.
- A SharePoint list: fine for short FAQ-style answers of a line or two, but it can’t hold formatted steps and images like a page.
- Classic wiki page library: the older approach. Modern pages can only be created in Site Pages, so I’d start new knowledge bases there.
Which method should you use?
| Situation | Use | Why |
|---|---|---|
| One site, a few dozen articles | Method 1 | No code, any owner can maintain it |
| Same setup on several sites or bulk loads | Method 2 | Repeatable script, easy to add articles |
| Card or carousel look on the home page | Highlighted content (Method 3) | Visual layouts across page libraries |
| Two-line FAQ answers | A SharePoint list | Quick to add and filter |
Most teams start with Method 1 and add the script later. Browse SharePoint intranet examples for landing page ideas.
To announce new articles, publish a SharePoint news post or roll them into a SharePoint newsletter.
Things to Keep in Mind
- Home page shows up in the list: add the “KB Category is not empty” filter to the view.
- Category doesn’t stick: republish the page after changing Page details.
- Can’t edit page properties: you need owner or designer permission on the site.
- Readers editing articles: lock pages down with read-only pages for members, or turn on content approval.
- Stale answers: keep Modified in the view and review anything older than six months.
Find more page and web part walkthroughs in our SharePoint tutorials.
If you’re growing your intranet, these walkthroughs pair well with a knowledge base:
Frequently Asked Questions
Does SharePoint have a knowledge base template?
Not a dedicated one. The simplest approach is Site Pages with a category column, a grouped view, and a landing page that shows that view in a Document library web part.
Can I use SharePoint as a wiki?
Yes. Modern pages work like wiki articles, and Microsoft’s modern pages guide notes they can only be created in the Site Pages library.
How do people search a SharePoint knowledge base?
Use the search box at the top of the site. In our test, a new article showed up in site search about five minutes after publishing.
How do I organize knowledge base articles by category?
Add a Choice column to Site Pages, set it on each page in Page details, and group a view by that column.
Can I show knowledge base articles as cards?
Yes. The Highlighted content web part can pull pages from the site’s page library and show them as Cards, List, Carousel, Compact or Filmstrip.

Hey! I’m Bijay Kumar, founder of SPGuides.com and a Microsoft Business Applications MVP (Power Automate, Power Apps). I launched this site in 2020 because I truly enjoy working with SharePoint, Power Platform, and SharePoint Framework (SPFx), and wanted to share that passion through step-by-step tutorials, guides, and training videos. My mission is to help you learn these technologies so you can utilize SharePoint, enhance productivity, and potentially build business solutions along the way.