Contact us

Installation and setup

Virto Portfolio is not yet listed in the SharePoint Store or the Teams Store. The steps below describe how it is added once it is. Until then, contact sales.

Virto Portfolio is installed once for your organization and set up once on each SharePoint site that holds a portfolio. One site holds one portfolio, and setting it up needs a site owner. Start in SharePoint: the web part needs nothing more than the app itself. Teams, Outlook, the Microsoft 365 app and the browser tab are optional; they need the approval of an administrator once for the organization.

StepWhoWhere
1. Add the app to SharePointSharePoint AdministratorSharePoint admin center
2. Add the web part to a pageSite ownerA page of the portfolio site
3. Set up the portfolioSite ownerThe web part, once per site
4. Give people accessSite owner or a Portfolio OwnerSettings → Permissions in the app, or the SharePoint groups of the site
5. Add the app to Teams and Outlook (optional)Teams Administrator; a Global, Cloud Application or Application Administrator for the approval; then team ownersTeams admin center, Microsoft Entra ID, then a channel, chat or meeting

Set up in SharePoint

1. Add the app to SharePoint

Virto Portfolio is added from the SharePoint Store (Microsoft AppSource). A SharePoint Administrator adds it for the organization:

  1. In the SharePoint admin center, go to More features and select Open under Apps.
  2. On the Manage apps page, select SharePoint Store, find Virto Portfolio and select it.
  3. Select Add to Apps site. If every site may use the web part, select Enable this app and add it to all sites; otherwise site owners add it to their sites in step 2.
  4. Select Add.

See Manage apps using the Apps site on Microsoft Learn. When the app is added to all sites, it can take a while before it reaches each site. Do not add it to a site by hand in that time.

The app asks for one API permission: Microsoft Graph, User.ReadBasic.All, to show people’s profile photos. It is approved in SharePoint admin center → Advanced → API access; Microsoft requires a Global Administrator to approve a Microsoft Graph permission there. See Manage access to Microsoft Entra ID-secured APIs on Microsoft Learn. Until then, and if you decline it, the app works and shows people’s initials instead of their photos. In SharePoint the app needs no Microsoft Entra app of its own; see Permissions and data.

The web part loads its scripts from https://portfolio.virtosoftware.com/js/. When the app is added, SharePoint adds this address to the trusted script sources of your tenant by itself: it is listed in SharePoint admin center → Advanced → Script sources with the status Imported from app catalog. See Support for Content Security Policy (CSP) in SharePoint Online on Microsoft Learn.

2. Add the web part to a page

  1. If the app is not on the site yet, a site owner adds it: Site contents → New → App → Virto Portfolio. If it is not in the list, ask the SharePoint Administrator to add it to SharePoint.
  2. Open a page of the site, or create one, and select Edit.
  3. Select +, find Virto Portfolio and add the web part.
  4. Republish the page.

Web part settings

To change them, edit the page, select the web part and then the settings button in its toolbar. The settings take effect when you select Apply.

The property pane of the Virto Portfolio web part: Portfolio site set to This site with its explanation, an empty Audience targeting field, Appearance with the Full width check box, and the Apply button
The settings of the web part
  • Portfolio site: the site whose portfolio the web part shows. This site is the site of the page. The list also offers the other sites of your organization that have a portfolio and that you can open. Everyone sees the chosen portfolio with their own permissions on that site, and its settings stay with that site.
  • Audience targeting: people, Microsoft 365 or security groups, and SharePoint groups who see the web part. Empty means everyone. It only decides who sees the web part on the page; who may open and change the portfolio is still decided by the permissions of the site. Page editors always see the web part in edit mode.
  • Full width: gives the web part the whole width of the page section, so that the Gantt chart and the Load page have more room.

3. Set up the portfolio

The first time a site owner opens the page, the web part shows Set up the portfolio on this site with the address of the site.

Set up the portfolio on this site: the address of the site, an explanation of the lists, groups and permissions it creates, the Base currency field with USD, and the Set up the portfolio button
The setup form, as a site owner sees it
  1. In Base currency, enter the three-letter ISO code of the currency in which costs and currency rates are counted, for example USD or EUR. It is set once: later the app shows it in Settings → General and does not let you change it, because costs and rates already counted in it would have to be recalculated.
  2. Select Set up the portfolio. It takes about a minute.

The setup creates on the site:

  • 18 lists whose names start with “Portfolio”: Portfolio Projects, Portfolio Programs, Portfolio Project Roles, Portfolio Assignments, Portfolio Milestones, Portfolio Resources, Portfolio Resource Days Off, Portfolio Calendars, Portfolio Calendar Holidays, Portfolio Roles, Portfolio Departments, Portfolio Locations, Portfolio Skills, Portfolio Unit Types, Portfolio Currencies, Portfolio Project Types, Portfolio Project Statuses and Portfolio Project Priorities. Versioning is on in each of them.
  • Two SharePoint groups, named after the site: <site title> Portfolio Owners and <site title> Portfolio Managers. The person who runs the setup is added to Portfolio Owners, and Portfolio Owners becomes the owner of both groups.
  • Permissions on the lists: they stop inheriting the permissions of the site and get the ones described in Who can do what.
  • Starter values: the unit types Hours (1 hour) and Days (8 hours), the calendar Standard (Monday to Friday, 8 hours a day), the statuses Planned, In progress, On hold, Completed and Cancelled, and the priorities High, Medium and Low, each with a color. Standard becomes the default calendar.

The setup needs a site owner: a person who can manage the site, manage its permissions and create groups. Anyone else sees “The portfolio is not set up on this site yet. A site owner needs to open this page once to set it up.”

A site owner can also set up the portfolio outside SharePoint, on the Welcome screen of portfolio.virtosoftware.com, once an administrator has approved the app for the organization. See Personal app, Outlook and the Microsoft 365 app.

If the setup stops half-way, run it again. It creates only what is missing and deletes nothing.

The Standard calendar has no country, so it has no public holidays yet. Choose its country in Dictionaries → Calendars. See Calendars.

On an empty portfolio, the Getting started panel opens once by itself, and the Projects page offers Load demo data. See Excel export and import.

Update the portfolio

When a new version of the app needs new lists or columns, a site owner who opens the portfolio sees Update the portfolio. The update adds what is new; nothing is deleted, and permissions you changed are kept. Until a site owner runs it, everyone else sees “The portfolio on this site needs an update. A site owner needs to open this page once to update it.”

4. Give people access

A Portfolio Owner gives access in Settings → Permissions: it lists the members of the two groups of the site, and lets you add people or groups and remove members. You can also manage the two groups in SharePoint, in Settings → Site permissions → Advanced permissions settings. Members of Portfolio Owners can manage both groups without being site owners. See Permissions.

  • Portfolio Owners: everything in the portfolio, including resources, project types, statuses, priorities, the settings and the members of the two groups.
  • Portfolio Managers: projects, their roles, assignments and milestones, and the dictionaries except the Owners-only ones.
  • Everyone else who can open the site (site members and visitors): sees the portfolio and cannot change it.

The full table is in Who can do what.

Add the app to Teams, Outlook and the Microsoft 365 app

The Teams app opens the portfolio of a SharePoint site from https://portfolio.virtosoftware.com. It signs people in with the Microsoft Entra app Virto Portfolio App, which the SharePoint web part does not need.

1. Make the app available and approve it

  1. A Teams Administrator makes Virto Portfolio available in Teams. It comes from the Teams Store; in the Teams admin center it is under Teams apps → Manage apps.
  2. A Global Administrator, a Cloud Application Administrator or an Application Administrator approves Virto Portfolio App once for the organization (tenant-wide admin consent in Microsoft Entra ID). A SharePoint Administrator or a Teams Administrator cannot. One approval covers the three delegated permissions the app asks for: SharePoint AllSites.FullControl and Microsoft Graph User.Read and User.ReadBasic.All. People cannot accept AllSites.FullControl for themselves, so without the approval nobody can sign in. See Permissions in Teams, Outlook, the Microsoft 365 app and the browser tab.

To approve the app, the administrator opens the link Approval page for the administrator that the app shows until the approval is given, or follows Grant tenant-wide admin consent to an application on Microsoft Learn.

Until the app is approved, signing in fails with “Sign-in did not complete”, and the app shows: “Virto Portfolio needs your Microsoft 365 administrator’s approval once for the organization (full control of SharePoint sites, to set up the portfolio’s lists, groups and permissions). Send this page to your administrator:”, followed by the approval link.

2. Add a tab to a channel, chat or meeting

  1. In a channel, a group chat or a meeting, select + (Add a tab), find Virto Portfolio and add it.
  2. The configuration page signs you in and lists the SharePoint sites that have a portfolio and that you can open, by title. The team’s own site is marked (this team). Choose the site whose portfolio the tab opens.
  3. If the site is not in the list, choose Another site… and enter its address. A link to a page or a list of the site works too. If the portfolio is not set up there yet, the tab shows how to set it up.
  4. Select Save. It stays unavailable until a valid site is chosen.
The Virto Portfolio tab configuration in Microsoft Teams, with the app icon and name in its header: Choose the SharePoint site whose portfolio this tab opens, then select Save, with the site Dev selected and its address below
Choosing the site of a Teams tab

To point the tab to another site later, open the tab’s Settings. The tab always opens the site chosen there.

Virto Portfolio as a tab of the General channel in Microsoft Teams, showing the Gantt page with the programs Digital workplace and Finance transformation on a month scale, the Today, All dates and Expand all buttons, and the line for today
Virto Portfolio as a channel tab in Teams

Tabs work in standard, private and shared channels; a private or shared channel has its own SharePoint site, and that site is the one marked (this team). Guests of the team can use the tab; a guest needs the approval of the organization whose site the portfolio is on, not of their own. People from another organization who take part in a shared channel without a guest account in your organization (B2B direct connect) cannot.

3. Personal app, Outlook and the Microsoft 365 app

Each person can also open Virto Portfolio as a personal app in Teams. Outlook and the Microsoft 365 app show the personal app once it is installed in Teams. A personal app has no team site, so it starts at the root site of your organization:

  • If the root site has a portfolio, it opens.
  • If not, the app shows Welcome to Virto Portfolio. Open a portfolio lists the portfolios of your organization that you can open; select one to open it.
  • People who may set up a portfolio on the root site also get the setup form there. Anyone else is shown how a site owner sets it up in SharePoint.
Welcome to Virto Portfolio in a browser tab: There is no portfolio on this site yet, with the address of the site; Open a portfolio with the portfolio Dev; and Set up the portfolio on this site with the Base currency field and the Set up the portfolio button
The Welcome screen on a site without a portfolio, as a site owner sees it

The portfolio you choose is remembered in that browser or in Teams on that device, and opens directly next time instead of the root site. To open another one, select Switch portfolio (the arrows at the right of the navigation): it lists the portfolios of your organization that you can open, with the current one marked (open).

Sign-in

In Teams, Outlook and the Microsoft 365 app, the app signs you in with the account you already use there. In a browser tab, the page signs you in by itself. If the sign-in cannot start by itself, the app shows Sign in.

In a browser tab

The same screens open in a browser at https://portfolio.virtosoftware.com/?SPHostUrl=<address of the site>, for example https://portfolio.virtosoftware.com/?SPHostUrl=https://contoso.sharepoint.com/sites/pmo. Without an address, the page opens the portfolio you chose last in that browser, or the root site of your organization with the Welcome screen. A bar at the top links back to the SharePoint site.

Virto Portfolio in a browser tab: a blue bar with SharePoint site on the left and Virto Portfolio in the middle, the Projects page with the projects grouped by program, and the Switch portfolio menu open with the portfolio Dev marked open
Virto Portfolio in a browser tab, with the Switch portfolio menu open

Setup and settings outside SharePoint

Once the app is approved, the portfolio is set up, updated and removed, and the members of its groups are changed, in Teams, Outlook, the Microsoft 365 app and the browser tab as in the web part. What each person may do still follows their own permissions on the site.

If something does not work

MessageWhat to do
The portfolio is not set up on this site yet. A site owner needs to open this page once to set it up.A site owner opens the portfolio and runs the setup. See Set up the portfolio.
The portfolio on this site needs an update. A site owner needs to open this page once to update it.A site owner opens the portfolio and runs Update the portfolio.
Steps to set up or update the portfolio on the SharePoint site (in Teams, Outlook or a browser tab)Follow the steps shown: a site owner sets up or updates the portfolio in the SharePoint web part. Then reload the tab.
Virto Portfolio needs your Microsoft 365 administrator’s approval once for the organization…An administrator approves the app. See Make the app available and approve it.
You can view the projects; ask a portfolio owner for editing rights.A Portfolio Owner adds you to Portfolio Managers or Portfolio Owners.
Sign in with your work account to open the portfolio.Select Sign in and use your work account.
Set the default calendar in the settings first: the project moves by its working days.A Portfolio Owner chooses the default calendar in Settings → General.
“…” is in use and cannot be deleted.Other items still use the value. Change them first, then delete the value.
The removal did not finish; run it again to complete itA site owner runs Remove the portfolio… again. See Remove the portfolio.
The Portfolio license ended on … The portfolio is read-only: you can view it and export it to Excel.Renew the license. See License.
Updated on November 18, 2026