> For the complete documentation index, see [llms.txt](https://docs.supria.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supria.com/home/get-started/supria-project-connector/using-the-connector.md).

# Using the connector

Learn how to install and use the connector.

There are two ways to bring your schedule from Microsoft Project into Supria Workspaces: upload a file through your browser, or publish directly from Microsoft Project Professional. Use whichever option fits how your team already works.

This connector runs locally in Microsoft Project Professional (desktop), so it doesn't depend on Project Online.

***

### Before you begin

* You need **permission to import** the project schedule.
* Supported files: `.mpp` files from **Microsoft Project Professional 2013 through 2024**.
* Limits: up to **500 MB** and approximately **20,000 tasks per file**.

***

### Install the connector

Install the Supria Project Connector **individually on each machine** you'll use with Supria Workspaces. To install and set up the connector, follow these steps:

{% stepper %}
{% step %}
Install the Supria Project Connector from this [**link**](https://connector.supriaworkspaces.com/).

{% hint style="warning" %}
**If you already have an earlier version installed, uninstall it first to avoid conflicts with the new version.**
{% endhint %}

{% stepper %}
{% step %}
On the page that opens, click **Install Supria Project Connector**.
{% endstep %}

{% step %}
When the connector installer appears, click **Install**.
{% endstep %}

{% step %}
Open or restart Microsoft Project.
{% endstep %}

{% step %}
The Supria Workspaces panel appears on the Microsoft Project ribbon.
{% endstep %}
{% endstepper %}
{% endstep %}

{% step %}
Open Microsoft Project Professional.
{% endstep %}

{% step %}
Select **Supria** on the toolbar.
{% endstep %}

{% step %}
In the Supria panel, on the right side, sign in with your Microsoft 365 account:

{% stepper %}
{% step %}
In the Supria side panel, select **Sign in with Microsoft 365**.
{% endstep %}

{% step %}
Enter your Microsoft 365 email and password.
{% endstep %}

{% step %}
Select **Confirm and connect**.
{% endstep %}

{% step %}
If you're already signed in with another account, select **Connected** in the corner of the Supria panel to sign out, then sign in again with the correct account.
{% endstep %}
{% endstepper %}
{% endstep %}
{% endstepper %}

***

### Publish the global template

This step makes your organization's custom fields available to the connector.

You typically do this only once, and only the person who administers your Supria environment needs to do it. You only need to repeat it if those fields change later.

{% hint style="warning" %}
**The Supria Project Connector must be installed and connected in Microsoft Project Professional.**
{% endhint %}

{% stepper %}
{% step %}
In Microsoft Project Professional, open your organization's global template (.mpp) file.

This is your organization's project template, with all project settings already set up in the Organizer: views, linked tables, client calendars, your custom fields, and Supria's reserved fields.
{% endstep %}

{% step %}
Click **Supria** on the toolbar and select **Global template**.
{% endstep %}

{% step %}
If you've already published the global template once, you need to reset it to avoid conflicts. To reset the template:

{% stepper %}
{% step %}
In the Supria side panel, scroll to the bottom to find **Reset global template**.
{% endstep %}

{% step %}
Click **Reset global template**.
{% endstep %}

{% step %}
Type **reset** in the confirmation box and click **Reset template**.
{% endstep %}
{% endstepper %}
{% endstep %}

{% step %}
Click **Read fields from open project**.
{% endstep %}

{% step %}
Review the fields found and select the ones you want to publish.
{% endstep %}

{% step %}
Select **Publish X field(s)**.

{% hint style="info" %}
**X shows the number of custom fields.**
{% endhint %}
{% endstep %}

{% step %}
Close the global template file.
{% endstep %}

{% step %}
To confirm the template published successfully, go to Supria Workspaces Web and select **Settings > Supria Project Connector**.

The template's fields appear in the list of published fields.
{% endstep %}
{% endstepper %}

***

### Publish a schedule

To publish a schedule using the connector, follow these steps:

{% stepper %}
{% step %}
With the connector installed and connected, open Microsoft Project Professional and click **Supria** on the toolbar.
{% endstep %}

{% step %}
Click **Open** on the toolbar, then click **Open project** in the Supria panel on the right.
{% endstep %}

{% step %}
Select the project you want in the Supria panel and click **Open project**.

{% hint style="info" %}
You can use the panel's search field to find your project.
{% endhint %}
{% endstep %}

{% step %}
If needed, make changes to the schedule, then select **Submit**.
{% endstep %}

{% step %}
Check how many custom fields were found.

{% hint style="info" %}
If you need to make any changes, you can discard the submission and resubmit.
{% endhint %}
{% endstep %}

{% step %}
When everything looks correct, select **Publish schedule**.
{% endstep %}
{% endstepper %}

#### What you should know

* Empty custom fields don't block publishing. You'll just see a warning so you can fill them in later.
* If a file is invalid, too large, or exceeds the task limit, Supria Workspaces tells you exactly what to fix before you try again.
* After you open the schedule in Supria Workspaces, it can take a few minutes for all statistics to finish calculating.
* If the connector has problems after an update (for example, if a button doesn't appear where you expect), reinstalling it usually fixes the issue.

#### Why this matters

Publishing takes only a few clicks, but it's what keeps your schedule, budget, and status reports aligned, without anyone having to reconcile them manually.

***

### Publish a schedule from Supria Web

If you already have the project created in Supria Workspaces and the Project .mpp file, follow these steps to publish your schedule directly in Supria Workspaces Web.

{% stepper %}
{% step %}
In Supria Workspaces Web, open your project and select **Schedule** in the left sidebar.
{% endstep %}

{% step %}
On the Schedules screen, click **Create schedule**.
{% endstep %}

{% step %}
Choose **MPP file** as the source.
{% endstep %}

{% step %}
Name the schedule and, if needed, add a short description.
{% endstep %}

{% step %}
Click **Save** to create the application.

The system creates the schedule application and shows an empty screen with an **Import MPP file** button.
{% endstep %}

{% step %}
Click **Import MPP file**.
{% endstep %}

{% step %}
Select or drag the `.mpp` file.
{% endstep %}

{% step %}
The file is processed, and you'll see a summary when processing finishes.

* If the information is correct, select **Publish schedule** to make it official.
* If you need to make a correction, select **Cancel and discard**, make your adjustments, and repeat the steps
  {% endstep %}
  {% endstepper %}

***

### Update a schedule

If your plan changes, republish the schedule or update the file through Supria Workspaces Web.

Supria Workspaces keeps a complete history of every published version, and any baselines you've already saved carry over automatically, keeping planned-versus-actual comparisons intact.

#### Confirm the changes

When you republish the schedule, you must confirm the process in Supria Workspaces Web

{% stepper %}
{% step %}
Open Supria Workspaces Web.
{% endstep %}

{% step %}
Open your project and click **Schedules**.
{% endstep %}

{% step %}
You'll see a message indicating the import is ready for review.
{% endstep %}

{% step %}
Click **Review**.
{% endstep %}

{% step %}
Check the schedule information.

* If the information is correct, select **Publish schedule** to make it official.
* If you need to alter, select **Cancel and discard**, make your adjustments, and try publishing the schedule again.
  {% endstep %}
  {% endstepper %}