# Projects

## What is a Project?

A Project is a container for multiple [Events](https://products.monterosa.co/mic/creator-guide/spaces/projects/events). 

<figure><img src="https://2539678054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq9pQqNk9IovpAN9EXqbX%2Fuploads%2FbOmQAUCm9LSvYCmwNQy1%2Fimage.png?alt=media&#x26;token=c777204a-7bdc-432a-a128-e3cc0731d991" alt=""><figcaption></figcaption></figure>

## How do I create a Project?

Click on the ***+ New Project*** button on the *Projects* screen. Give your Project a name, thumbnail and assign tags for identification.&#x20;

<figure><img src="https://2539678054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq9pQqNk9IovpAN9EXqbX%2Fuploads%2FO6ZPE1tRbr9h6GYLCgZP%2Fimage.png?alt=media&#x26;token=2cfabb2e-7bf2-4d46-95d6-e3cec12edda4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

### What role must I have in order to create a Project?

A member must have Admin role for this Organisation / Space in order to create a Project. More information on Teams and their Roles can be found [here](https://products.monterosa.co/mic/team#what-are-roles).
{% endhint %}

## How do I associate an App with my Project?

When creating a [Project](https://products.monterosa.co/mic/creator-guide/spaces/projects) an App can be associated. The App menu will display all [Apps](https://products.monterosa.co/mic/creator-guide/spaces/projects/app-settings) that have previously been added to this Project. Simply select one from the menu to associate it with this Project. Every Project must have an associated App and so a Project cannot be created without one selected.&#x20;

Alternatively you can upload a new App via its app spec URL. App spec URLs can be provided by the Monterosa team. Please contact our support team at <support@monterosa.co.uk> in order to discuss your App requirements.

## How do I edit a Project?

When in list view, click on the ***menu*** icon at the end of a Project row.

&#x20;When in Project card in grid view, hover on the ***Space*** home screen and select ***Edit Project*** from the menu icon.

{% hint style="info" %}

### What role must I have in order to add or edit Project?

A member must have Admin role for this Organisation / Space in order to add or edit a Project. More information on Teams and their Roles can be found [here](https://products.monterosa.co/mic/team#what-are-roles).
{% endhint %}

## How do I delete a Project?

To protect against accidental Project deletion, please contact our support team at <support@monterosa.co.uk> in order to delete a Project.&#x20;

## Can I archive a Project?

Yes, Projects can be archived by clicking on the ***menu*** icon at the end of a Project row in list view or Project card in grid view on the ***Space*** home screen and selecting ***Archive Project**.*&#x20;

We recommend archiving Projects when all Events have finished and there is no longer a need to run any new Events. Listings data from your past Events will still be available. &#x20;

To protect against accidental archival of a Project, the name of the Project must be typed before confirming this action.&#x20;

{% hint style="danger" %}

### Once archived this action cannot be undone

When Archiving a Project, it will be unretrievable and the following actions will be performed:

* Stop loading the App
* Stop all Events
* Unschedule any scheduled Events
* Remove any Enmasse data
  {% endhint %}

<figure><img src="https://2539678054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq9pQqNk9IovpAN9EXqbX%2Fuploads%2FicOr4K486pERJEG98WFO%2Fimage.png?alt=media&#x26;token=0f2a3855-546e-4fe2-a8c4-8fc4466cf14e" alt=""><figcaption></figcaption></figure>

## How do I add tags to a Project?

Tags can be added to Projects in order to organise and group them. You can create as many tags as you like and assign them to Projects. When editing a Project use the tag field to either choose an existing tag from the list or type and hit "Add" under the tag field to add a new one.&#x20;

All tags can be globally managed within a Space in the [Space Settings](https://products.monterosa.co/mic/creator-guide/spaces/setup/space-settings).&#x20;

{% hint style="info" %}
Amending tags within Space Settings affects tags that have already been applied.
{% endhint %}

<figure><img src="https://2539678054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq9pQqNk9IovpAN9EXqbX%2Fuploads%2FFNnjrh0o7nYHeYNQg7T3%2Fimage.png?alt=media&#x26;token=01ee44fe-603d-45f4-afd1-82d3a7453369" alt=""><figcaption></figcaption></figure>

## How can I organise my Projects?

Projects can be sorted by (ascending & descending):

* Created - Time the Project was created
* Name - Alphabetically&#x20;
* [Concurrent Users](#what-are-the-stats-displayed-on-a-project) - Number of users who are simultaneously connected to the platform within an Event.
* [Total Users](#what-are-the-stats-displayed-on-a-project) - Overall number of unique user IDs connected to all Events within a Project.

<figure><img src="https://2539678054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq9pQqNk9IovpAN9EXqbX%2Fuploads%2FHlXtyGPdUWTsGzA0QDp7%2Fimage.png?alt=media&#x26;token=627adcc3-9be3-4c16-a5ad-7136b408755b" alt=""><figcaption></figcaption></figure>

## How do I favourite a Project?

You can favourite Projects so that they are grouped together in a separate favourites list. Simply click on the ***menu*** icon at the end of a Project row in list view or Project card in grid view for the Project you wish to favourite and click on the ***Favourite Project***. This will add the Project to the favourites list.&#x20;

<figure><img src="https://2539678054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq9pQqNk9IovpAN9EXqbX%2Fuploads%2FoKA7tuLaQpUijT4NXiTi%2Fimage.png?alt=media&#x26;token=5677c88e-e9c5-4987-ba0a-9a8855ad1660" alt=""><figcaption></figcaption></figure>

## Is there a limit to how many Projects I can create?

There is no limit on the number of Projects that can be created within a Space! However we do recommend regular clean up of idle Projects such as those with no live Events by using the Archive feature. See [Archiving a Project](#can-i-archive-a-project) for more information.

## Can I view Events directly from the Project list?

Yes, simply hover over the Project row in list view or Project card in grid view and click on ***preview Event***.&#x20;

{% hint style="info" %}
This opens the latest live Event within the Project.&#x20;
{% endhint %}

<figure><img src="https://2539678054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq9pQqNk9IovpAN9EXqbX%2Fuploads%2FFn0bJpzXK0OSIXtGeHJJ%2Fimage.png?alt=media&#x26;token=8494ed15-1f24-4c36-a0bd-3814003bb65e" alt=""><figcaption></figcaption></figure>

## What are the stats displayed on a Project?

<table data-header-hidden><thead><tr><th width="190"></th><th></th></tr></thead><tbody><tr><td>Concurrent Users</td><td>The number of users who are simultaneously connected to the platform within an Event.</td></tr><tr><td>Total Users</td><td>The overall number of unique user IDs connected to all Events within a Project.</td></tr></tbody></table>

## How do I find the Project ID?

When inside an Project the Project ID can be viewed and copied on hover of the Project title in the breadcrumb. Click on the # icon which appears next to the Project title and the Project ID becomes visible with the option to copy it.