NOTEThis feature will be released in version 8.6.0.0 for SharePoint Online and is not currently available.
Creating a subsites navigation menu in SharePoint is super simple with the Microsoft Graph API connection. All you have to do is use the “Subsites of a SharePoint Site” use case. To get started, follow the steps below.
TABLE OF CONTENTS
Prerequisites
- You must have ShortPoint SPFx version 8.6.0.0 and up installed on your SharePoint environment.
- You must be a ShortPoint Designer with an active license.
- You must have the Microsoft Graph API connection enabled. Go to How to Enable Microsoft Graph Integration for MS Graph API Connections to learn how.
- You must authorize the necessary permissions (Sites.Read.All) in the API access page. To check, go to your SharePoint Admin Center > Advanced > API access.
- You must have the Design Element you want to use to connect on your SharePoint page. For best results, we recommend using Design Elements that allow listing of multiple items (e.g., Icon List, Image List, Simple List, etc.).
- You must have the Site ID of the SharePoint site you want to use. To get it, check out How to Get Your Site ID.
Step-by-step Tutorial
Follow the steps below to get started:
Step 1: Edit the ShortPoint Web Part
Go to the SharePoint page you want to use and click Edit:
Close the Toolbox:
Select the ShortPoint web part and click the Edit Properties icon:
Step 2: Switch to Grid Mode
NOTEShortPoint Connect is currently only available in Grid Mode.
Click the Switch to Grid Mode icon:
Step 3: Edit the Design Element
NOTEYou can use any Design Element you want. For best results, we recommend using Design Elements that allow listing of multiple items (e.g. Icon List, Image List, Simple List, etc.). For this guide, we’ll use Tiles.
Click the cogwheel icon of the Design Element you’ll use:
Step 4: Connect to Microsoft Graph API
Go to the Connect tab:
Select Microsoft Graph API:
NOTEYou need to enable the Microsoft Graph API connection before using it. Learn more about it in How to Enable Microsoft Graph Integration for MS Graph API Connections.
Step 5: Use the Subsites of a SharePoint Site Use Case
Search for Subsites of a SharePoint Site and select it:
You will be prompted to fill in the details under Query Parameters. To get the Site ID, click Get Parameter:
Look for the SharePoint site you want to use and copy its ID:
Click Go back:
Paste the copied ID in the field provided:
Then, select Run Query:
Click Connect:
Step 6: Map Items
Go to the Tiles tab:
NOTESince we are using the Tiles Design Element, items mapping is located in the Tiles tab. However, for most Design Elements, it is located in the Items tab.
Delete default content:
Use the link icon to map the properties you want to be displayed:
You can map any property you want. In our case, we used the following properties:
- #displayName in the Title field - shows the names of the subsites as the titles.
- #webUrl in the Link field - redirects to the actual subsites page.
(Optional) If you’re using Tiles, choose the icon you want to use:
NOTECheck out ShortPoint Connect: Basic Tutorial to learn more about mapping properties.
Step 7: Save
Click Preview to see how the Design Element will look:
Click Update to apply your changes:
Select the eye icon to see your page in real time:
Once satisfied, click Save:
Amazing! Your users can now easily navigate between the subsites of your SharePoint site.
TIPWant to easily find subsites? The Search & Filter Toolbar is your best bet! It helps your viewers find the subsite they need instantly. With it, they can search, sort, and filter through all those subsites without any hassle. Check out Getting Started: The Basics of the Search & Filter Toolbar to learn more.
Related articles: