Add widget to SharePoint site

Add new widget configuration

Open the HelpDesk site and navigate to the Settings tab using the left-hand navigation bar. Then click the Widgets button.

Widget button

To create a new widget, click the New widget configuration button. You can also edit an existing configuration by clicking the widget’s name. Note that editing the widget configuration applies to every existing widget with this configuration.

Create a new HelpDesk widget from the settings

Provide a Title for the widget and choose For SharePoint as its Type.

Configure widget features

Next, choose which Widget features to include. The dropdown options for the Default tab will change based on your selections.

Hint

Change the default tab to Knowledge Base to encourage users to search for answers first before submitting any tickets.

SharePoint widget

Tickets feature

To set up your ticket form, click Configure tickets feature to open additional settings.

SharePoint HelpDesk widget configuration

These are the tickets feature settings.

Tickets Feature Settings for a HelpDesk widget

Ticket creation form

Turn it off if you don’t need to create new tickets in the widget.

Requesters will only be able to see their existing tickets. You can place the ticket creation form on another page instead.

Display type

Choose how tickets are displayed in the widget, between two types:

List

HelpDesk web widget showing tickets as a list

Card

HelpDesk web widget showing tickets as cards

Requesters can switch between List and Card options using the display type buttons in the widget.

Ticket views

Categorize your tickets and choose which information your users see.

Parameter

Description

Display fields

Select which fields to display by typing the name and then picking it from the list that appears.

Order by

Sort your ticket list by a field’s value, such as ‘Ticket ID’ or ‘Title’. By default, tickets are sorted from oldest to newest.

Tickets per page

Limit the results.

Color

Select one of the available predefined colors to identify your view.

Include private comments

Limit which comments are visible.

Include tickets in sub-folders

Filter tickets based on which folder contains them (for example, hide archived tickets).

Find more information about working with CAML queries and creating custom views in this article.

Edit widget settings for a HelpDesk widget

Note

Display fields are cached for 30 minutes for optimization purposes. You will need to clear browser cache to apply your changes immediately.

  • Customize forms. You can change the default widget forms using Plumsail Forms product. Follow our documentation.

Knowledge base feature

Activate the feature to boost efficiency by helping users help themselves from your self-service portal.

Create a knowledge base of common issues and troubleshooting steps to reduce the number of support tickets.

Knowledge base tab within a HelpDesk widget

Follow these steps to add articles to the knowledge base:

  1. Add a category - Create a category to organize your articles.

  2. Add an article - Write and assign articles to the appropriate categories.

  3. Manage access - Configure article visibility to make them available in the widget.

Add widget to modern SharePoint page

After saving the widget settings, a configuration ID for SharePoint will be generated — copy it for inserting into the web part on a page.

Generated ID

Navigate to a page where you’d like to place a widget.

Pick Plumsail HelpDesk Widget web part from the menu to add it to your page:

Pick the HelpDesk web part

Once you added the web part you need to configure it. Just copy Configuration ID for SharePoint from the widget configuration form, open the widget settings and paste it to the corresponding web part property. Publish the page after that.

Copy ID option to insert the widget in a page

Use HelpDesk widget

Your HelpDesk self-service portal is now ready to use. When a user opens the page with the widget, it displays the default tab. In our case it’s the Knowledge base.

They can search the knowledge base for a solution before creating a support ticket.

HelpDesk widget positioned on a SharePoint page showing the knowledge base

If no answers are found, they can submit a new ticket using the New ticket button on the top-right corner.

Create ticket using HelpDesk widget

All tickets submitted by the current user appear in the My Tickets tab. Click any ticket to view its details.

HelpDesk widget positioned on a SharePoint page

Learn More: