Before you start
- You need permission to manage Documentation settings.
- To add an uploaded file, upload it to Documentation > Documents first. See Create and maintain portal documents.
- To link to a file stored elsewhere, have its sharing URL ready, and make sure the people who need it have access in that service.
Enable the Hub
1
Open Hub settings
Open Settings > Documentation and click the Hub tab.
2
Turn it on
Turn on Enable hub. This shows the hub tab and lets resources appear.
3
Name it and place it
Enter a Title. Under Navigation placement, choose Main Documentation page, Standalone page, or Use as the Company Overview sidebar item.
4
Save
Click Save hub. MSPortal shows Hub settings saved.
Upload a file and add it to the Hub
1
Upload the file to Documents
Open Documentation > Documents and click Upload. Choose a DOCX, XLS, XLSX, PDF, or CSV file, set its company and folder, and finish the upload.
2
Open Page layout
Return to Settings > Documentation > Hub and find Page layout.
3
Add a Document resource
Click + (Add resource) in Featured or in the section where the file should appear, and choose Document. Search for the file and select it. You can also pick an existing portal page or a shared provider document.
4
Choose the audience
Review Company and Who can see this.
5
Save the resource
Click Add resource and wait for the confirmation. Open the Hub and check the placement.
Link to a file stored elsewhere
1
Copy the sharing URL
Get the web link from the service that stores the file, such as SharePoint, OneDrive, or Google Drive.
2
Add a Link resource
In Settings > Documentation > Hub, click + (Add resource) in Featured or a section and choose Link.
3
Fill in the link
Enter a Link title, paste the sharing link into URL, and add a Description and an icon if you like. The URL must be valid, such as
https://example.com.4
Choose the audience and save
Set Company and Who can see this, then click Add resource. Check the link from the Hub.
Organize the Hub
1
Add a section
In Page layout, click Add section and enter a Section title. Choose a layout, column count, accent, and icon if you like.
2
Place resources
Drag resources into Featured or a section. Resources that are not placed show under Unassigned resources, and clients see them under More resources.
3
Edit or remove a resource
Use Edit resource to change a resource and click Save changes. Use Remove resource to take it off the hub. Removing a section moves its resources to Unassigned resources, and nothing is deleted.
Saving and visibility
- Save hub saves the hub’s title, enabled state, and placement.
- Add resource saves a new resource. Save changes saves edits to an existing one.
- Layout changes save on their own. Wait for the save to finish before you leave the page.
- A Link with no audience selected is hidden from everyone. A Document or Folder with no audience selected follows the visibility of its content.
- A resource whose source page or folder was removed shows Source content removed and does not appear on the client hub. Edit it to point at other content, or remove it.
Troubleshooting
Frequently asked questions
Can we add files somewhere in MSPortal or link to files?
Can we add files somewhere in MSPortal or link to files?
Yes. Upload a file in Documentation > Documents and add it to the Hub as a Document resource, or add a Link resource that points to a file stored elsewhere.
Does a Link resource copy the file into MSPortal?
Does a Link resource copy the file into MSPortal?
No. It opens the other service in a new tab. That service controls access.
Do I need Hudu or IT Glue?
Do I need Hudu or IT Glue?
No. Portal pages, uploads, and links work without a provider.