Live training: next batches coming soon. Join the waitlist:Waitlists open:Developer Training →Developer →Copilot Studio Training →Copilot Studio →

How to Create a Knowledge Base (Wiki) in SharePoint

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 passwordIT
How to connect to the SPGuides VPNIT
How to set up Outlook on your phoneIT (added later with PowerShell)
How to request time offHR
How to book a meeting roomFacilities

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

  1. Go to Settings > Site contents and open Site Pages.
  2. Select + Add column to the right of the last column.
  3. In Create a column, pick Choice and select Next.
  4. Name it KB Category, type the choices IT, HR and Facilities, and select Save.
SharePoint Site Pages library Create a column pane with the Choice column type highlighted

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

  1. On the site home page, select + New > Page.
  2. Pick the Blank template and select Create page.
  3. Type the title in Add a title, such as How to connect to the SPGuides VPN.
  4. Add a Text web part with the intro and the numbered steps.
  5. Select Publish.

Here’s our VPN article after publishing:

Published SharePoint knowledge base article page How to connect to the SPGuides VPN with numbered steps

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:

  1. Open the view menu and select Create new view. Name it Knowledge Base.
  2. Show Name, Title, KB Category and Modified.
  3. Filter so KB Category is not empty, and sort by Title.
  4. Group by KB Category and save the view.
SharePoint Site Pages library Knowledge Base view grouped by the KB Category column

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

  1. Create a new page titled SPGuides Knowledge Base.
  2. 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.”
  3. Select + and add the Document library web part.
  4. Pick Site Pages, then in Edit properties set View to Knowledge Base.
  5. Select Publish, and add the page to the site navigation.
SPGuides Knowledge Base landing page with the Document library web part listing articles grouped by category

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:

SharePoint site search for VPN showing the How to connect to the SPGuides VPN knowledge base article

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
PnP PowerShell console adding a fifth SharePoint knowledge base article and listing articles by category

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?

SituationUseWhy
One site, a few dozen articlesMethod 1No code, any owner can maintain it
Same setup on several sites or bulk loadsMethod 2Repeatable script, easy to add articles
Card or carousel look on the home pageHighlighted content (Method 3)Visual layouts across page libraries
Two-line FAQ answersA SharePoint listQuick 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.