The top of the help file requires a metadata section. This section helps Prospero display your help document and allows users to find it when they search for help. It is formatted like this:

```
---
title: How to write documentation
access: admin
related: [/another/help/document]
---
```

The data is added in a `key: value` format, and you can use any of the keys listed below.

## Accepted keys

:title
The title of the document (required).

:access
Used to limit access to the document. Can be one of the following values: `admin`, `producer`, `user` or `guest`.

:related
A comma separated list of paths to related help documents. When entering the paths, exclude the extension `.md`. The list also needs to be surrounded by square brackets. Here's an example, `[/admin/help/how-to-include-youtube-videos,/admin/help/how-to-edit-documentation]`. Matching documents will be included as links at the footer of the help document.

:series
Help documents can be written to follow each other, usually when a process is a complex one and needs to be split into smaller bite-sized documents. Documents in a series require a **home** document - a document to list all of the items in a series - and this document requires `series: true` in its metadata. All other documents in this series should direct `series` to the home document, like this: `series: /path/to/home-document`.

:delta
A number representing the order in which to list the document. Higher numbers place the document higher in the listing. Default is 0.

:match
A comma separated list of paths to related Prospero pages, surrounded by square brackets. When a wildcard is matched to a page where the user has opened the help widget, the document will be listed on the help home page. Wildcards can be used in these match paths in order to match multiple pages. For example, `[/dashboard/admin,/dashboard/admin/*]`.

:permissions
A comma separated list of the permissions required for when a user carries out the instructions in the document. The list should be surrounded by square brackets. Possible values are `smartscripts`, `media`, `assignments`, `groups`, and `admin`.

How to write help documentation

Adding metadata to a help document

Once you've written your help document, you can then commit it to be built into Prospero. The commit form is featured at the bottom of the editor.

![Example of committing a document](https://res.cloudinary.com/candt/image/upload/v1656280497/prospero_v3-docs/github-commit)

Once committed, you can expect your new help document to be published to the live site within the next 5 days. If you require these changes sooner then please [get in touch](mailto:generamics@gmail.com).

Publishing your help document

To create a new help document:

***

## Step 1

[Follow this link](https://github.com/Prospero-Digital/prospero-firebase/new/help/docs). It will take you to a document editor page in the Prospero codebase on Github.

![Creating a new help doc](https://res.cloudinary.com/candt/image/upload/v1656163956/prospero_v3-docs/create-a-help-doc.png)

***

## Step 2

Enter a new filename for the help document, formatted like this: `/main-category/sub-category/file-name.md`. Note that the filename is all lowercase with spaces replaced by hyphens, ending with `.md`.

![Example of directories being created](https://res.cloudinary.com/candt/image/upload/v1656153102/prospero_v3-docs/documentation-filename.png)

Creating a new help document

Help documents are pre-built pages generated from Prospero source code. To create a new help document you can follow the detailed instructions below.

Once you've entered the content for your help document, you can see a preview of how it will display in Prospero by clicking the Preview button in the header of the body editor.

![Github preview button](https://res.cloudinary.com/candt/image/upload/v1656160348/prospero_v3-docs/github-preview-button.png)

Github will format your document, and any image files will also be embedded in the preview.

Note that Youtube videos may not preview correctly in Github.

Previewing your help document

There are three types of help document you can write:

## General overview

Overview documents introduce the user to a topic and usually feature a few images to break up the text. It's common to create an overview document when introducing a series of related documents.

## Step-by-step guides

Step guides explain a process broken up into steps and are formatted as follows:

```
## Step 1

Explain the step, perhaps with an image where appropriate.

![Image explainer](https://path-to-image)
```

## Description lists

Description lists can be used to define values or lists of types, with the title prefixed by a colon, and the line that follows acting as the description.

```
:An item
A description directly underneath. Can [also include links](https://link-to-site).
```

Tips on styling your help document

## Adding images

1. Upload your file in the [Cloudinary media libray console](https://cloudinary.com/console/c-8d19ad8f7010699135e095799f7faf/media_library/folders/c0cd3554fa82e3ec106949d5e55e6857b4).
2. Open the uploaded file's three-dot menu and choose `Copy URL`.
   ![Copy URL example](https://res.cloudinary.com/candt/image/upload/v1656159912/prospero_v3-docs/cloudinary-upload.png)
3. In the Help document editor, paste the copied URL using the following syntax: `![Description of the media file](https://copied-url)`

## Embedding Youtube videos

Embed YT videos using the following syntax: `![Description of Youtube video](https://www.youtube.com/watch?v=video_id)`.

Adding media content to help documents

When writing `match` metadata in help documents, you can specify wildcards in the page paths. For example, `/dashboard/smartscripts/*` would match all programme edit pages such as `/dashboard/smartscripts/abcdef` and `/dashboard/smartscripts/123456`.

Single asterisks match single levels in the path, so `/dashboard/smartscripts/*` matches `/dashboard/smartscripts/abcdef` but doesn't match `/dashboard/smartscripts/abcdef/edit`.

Double asterisks match all following levels, so `/dashboard/smartscripts/**` matches `/dashboard/smartscripts/abcdef` **and** `/dashboard/smartscripts/abcdef/edit/123456`.

Using wildcards allows you to target entire page sections within Prospero, making your help documentation more visible.

Using wildcards to match multiple pages

Once you've entered your metadata, you can start writing the help document proper. The body of the content should feature one line below the three metadata hyphens, and should exclude the document title as this is included in the metadata section above it. So, for example:

```
---
title: A title
---

Help content starts here...
```

Content is entered in [Markdown](https://www.markdownguide.org) format - all newlines are converted to paragraphs, text preceded with hashes are converted to headings, and so on.

There are a few additional Prospero-specific formatting features that are explained in more detail in the *Related articles* section.

Writing the help document

## Step 1

Go to `Admin` > `Subscribers`

## Step 2

Press the `ADD SUBSCRIBER` button at the top left of the page.

## Step 3

Complete the details in the subscriber form, including:

* Email address of the subscriber (this should be the main user of the Producer account)
* Organisation name or subscriber's name
* Price in pence (this must be more than zero)
* Date to make the first charge (leave this field if you want to charge immediately)
* Optionally mark as incomplete if further details are required before sending the first invoice

## Step 4

Double-check the blue info text at the bottom of the form to confirm they match your intended billing amounts and schedule, then press `NEXT` to move onto permissions.

## Step 5

Set the permissions required for the Producer account. See related links below to learn more about permissions. Press `NEXT` when done.

## Step 6

Check the overview section to make sure all details are correct, then press `SAVE`.

## Step 7

Stripe will attempt immediate payment if a prior payment method is found, and if payment is successful, a receipt will be sent to the subscriber.

If no payment method is found an invoice will be generated and emailed to the subscriber.

If the subscriber form was marked as `Incomplete` a *draft invoice* will be created and you will then have 23 hours to finalise the details before the invoice is voided. To make changes to the invoice see the related links below.

## Step 8

If automatic payment has been successful Prospero will enable the Producer account. If the subscriber pays by BACs you'll need to manually [mark the invoice as 'paid' in Stripe](https://stripe.com/docs/invoicing/overview#paid). This will then trigger Prospero to enable the Producer account.

## Step 9

Finally, if the subscriber hasn't yet registered in Prospero then they should do so using the email address entered in step 3. Once signed in they will have full access to their new Producer account.

How to add a subscriber

When invoices are created by Stripe they may require further action before being accepted by the subscriber or billing customer.

***

## Alternative billing address

Sometimes the subscriber isn't the one paying the bill and an alternative billing email address is required. You can edit the customer record on Stripe to include multiple billing email addresses.

### Step 1

[Visit the Stripe Dashboard](https://dashboard.stripe.com/dashboard).

### Step 2

Enter the partial name or email address of the subscriber in the search bar at the top of the page, and select the subscriber's email from the results.

### Step 3

Press `Edit` in the customer details overview on the left of the page.

### Step 4

Scroll down to `Billing information` and deselect `Same as account email` under `Billing email`.

### Step 5

Enter the new billing email addresses, and press `Update customer` to save the changes.

***

## Purchase order number

Some subscribers require a purchase order number to be included in the header of the invoice. Once you have a PO number you'll need to apply it to an incomplete invoice.

*Note: This only occurs to incomplete invoices. If the invoice has been finalised then a new invoice will need to be created.*

### Step 1

[Visit the Stripe Dashboard](https://dashboard.stripe.com/dashboard).

### Step 2

Enter the partial name or email address of the subscriber in the search bar at the top of the page, and select the subscriber's email from the results.

### Step 3

Scroll down to the `Invoices` section of the customer record and choose `Edit invoice` from the 3-dot menu of the latest invoice.

### Step 4

Expand the `Advanced options` section, and press `Add a custom field` under `Custom invoice fields`.

### Step 5

Review the changes to confirm and send the invoice.

Changing invoice details

You can quickly and easily switch to another user's account via a handy option in your user menu:

![Switch account menu](https://res.cloudinary.com/candt/image/upload/v1656499846/prospero_v3-docs/Screenshot_2022-06-29_11.50.36.png)

Use this to see what subscribers and group members can see, help with building smartscripts, or guide users around in a window that matches their own.

Here's how to use it:

## Step 1

Sign into Prospero and press your user menu icon in the top right of the window (this should be a circular button with your avatar image or the first letter of your user name):

![User menu icon example](https://res.cloudinary.com/candt/image/upload/v1656500150/prospero_v3-docs/Screenshot_2022-06-29_11.55.10.png)

## Step 2

Choose `Switch account`.

## Step 3

Enter the email address of the account you want to switch to and press `SWITCH`.

## Step 4

If the email matches an active user account, Prospero will temporarily sign you in to the account and you will now be using Prospero as if you were that signed in user.

## Step 5

When you have finished, always make sure to switch back to your own account. Open the user menu and choose `Exit account`. You should then be back to being signed in with your own account.

## Notes

* Signing in to another user's account is always temporary. This means that if you refresh the page or close the window, the next time Prospero loads you will be signed out. Always choose `Exit account` to switch back to your own account, as this will return you to a permanent signin (where a page refresh or reloading of Prospero keeps you signed in).

* Prospero's smartscript builder isn't yet designed to be collaborative. Serious playback issues may occur if more than one user edits the same smartscript at once. Please use this facility with caution.

* If you want to have access to your own account while also browsing as another user, follow the above steps in an incognito window. There's no need to exit the account once you're done, as when incognito windows close they forget all signed in accounts.

How to switch to another user account

Assignments allow you to group a set of your smartscripts and assign them as tasks for a group of Prospero users to complete.

***

To create your own assignments, follow the instructions below.

An introduction to assignments

If you wish to export the collated data from your assignments there are several options available.

***

## CSV export

CSV stands for Comma Separated Values. It's an open file format compatible with any spreadsheet application. Use this export option if you wish to use your data in a spreadsheet or a data analytics service.

1. [Edit your assignment](/help/assignments/edit-assignment-details) from the `Assignments` page.

2. Click on the `Export data` field and choose `CSV export`.

3. A set of default Export variable fields will appear below the field:

   ![Default fields example](https://res.cloudinary.com/candt/image/upload/v1662731373/prospero_v3-docs/Screenshot_2022-09-09_14.49.07.png)

   If you have added a smartscript built with variables to your assignment, its variables will be included in this list.

4. Select the variables you wish to include in your CSV file.

5. If you wish to reorder the fields, press the `REORDER` button and drag and drop the fields into the preferred order.

6. Press `SAVE` to save your changes.

7. You can access your CSV file from the assignment's progress page (see [Monitoring your assignment's progress](/help/assignments/monitoring-assignment-progress) for more details).

## Smartscript generator

A Smartscript generator switches out a Frame smartscript's placeholders with data collated from your assignment's smartscripts, and saves this newly generated smartscript into a programme of your choice.

![Generator diagram](https://res.cloudinary.com/candt/image/upload/v1662733974/prospero_v3-docs/Blank_board_-_Page_1_Frame_1.png)

Think of it like a smartscript building factory run by your assignees playing smartscripts!

1. [Edit your assignment](/help/assignments/edit-assignment-details) from the `Assignments` page.

2. Click on the `Export data` field and choose `Smartscript generator`.

3. A set of default Export options will appear below the field:

   ![Default export options](https://res.cloudinary.com/candt/image/upload/v1662734513/prospero_v3-docs/Screenshot_2022-09-09_15.41.37.png)

   Press `EDIT` to make changes.

4. Choose a Frame smartscript (a smartscript built with placeholders) and a destination bundle (the location to store generated smartscripts).

5. All placeholders found in the Frame smartscript will now be listed in the form.

6. For each placeholder you can select a variable to replace it with from the pulldown list (the list of variables is generated from the smartscripts you added to the assignment - see [Editing assignment details](/help/assignments/edit-assignment-details)).

7. You can also use a custom value by checking the `Custom?` checkbox and entering your own value. 8. Press `UPDATE` to apply your changes, then `SAVE` to save the assignment details.

Choosing an exporter

Creating assignments is quick and easy. Just enter a title to build an assignment shell.

***

## Step 1

Go to `Assignments` and click `Add a new assignment` in the `Drafts` section.

## Step 2

Enter a title for your assignment.

## Step 3 (optional)

If you have a Prospero file you've downloaded from another assignment, you can attach it via the `Have a Prospero file?` link.

## Step 4

Click `Save` to create your assignment. It will be listed in the `Drafts` section.

Creating an assignment

Once an assignment has been created, you'll need to edit its details.

***

## Step 1

Go to `Assignments` and find the assignment you wish to edit.

## Step 2

![Not yet assigned example](https://res.cloudinary.com/candt/image/upload/v1662730165/prospero_v3-docs/Screenshot_2022-09-09_14.27.23.png)
If your assignment has not yet been assigned, press the `Edit` button to the bottom of the card.

![Assigned example](https://res.cloudinary.com/candt/image/upload/v1662730165/prospero_v3-docs/Screenshot_2022-09-09_14.27.32.png)
If your assignment has already been assigned, press the three dot menu to the bottom-left of the assignment card and select `Edit details`.

## Step 3

Your assignment requires a title, a description, a deadline, and a list of smartscripts to group as assigned tasks.

We recommend you also upload a thumbnail to make your assignment stand out in the listings.

## Step 4

For the `Export data` field, see [Choosing an exporter](/help/assignments/choosing-an-exporter).

Editing assignment details

You can watch your assignee's progress from your assignment progress page.

***

## Accessing the progress page

Once you've added assignees to your assignment, a new `PROGRESS` button will appear. Clicking this will take you to the progress table which outlines your assignee progress with the following columns:

* Email
  *Assignee username and email address*
* Progress
  *Progress status displayed as a progress bar*
* Variable columns
  *More details on these below*

Each row can be expanded to show more information on each assignee's progress, featuring the names of each of the assigned smartscripts along with their progress status.

At the top of the table is a button to access or change the settings of the assignment exporter, along with a search field to filter the table rows.

## Switching progress grouping

The `Email` column can be switched to `Smartscript`, which then groups the rows by smartscript. Expanding each item displays every assignee and their progression status for that smartscript.

## Adding variable columns

If you wish to monitor smartscript variables (including any text or media inputted by the assignee), click the `ADD COLUMN` button and choose the variable from the list. The value of this variable will update in real time.

## More on progress status

After signing into Prospero and visiting their Assignments dashboard, an assignee's smartscript session documents are automatically generated. This process also adds them to the Progress table and assigns the progress status `NOT STARTED`.

Once the assignee presses the `PLAY` button, the progress status moves on to `STARTED`, and their progress bar increases. Once the assignee completes a smartscript, the progress status moves to `COMPLETED` and their progress bar is full.

Monitoring assignment progress

A Smartscript is our name for a workshop or lesson you make in Prospero. Think of a Smartscript as an interactive lesson plan. It has all the instructions, tasks and activities you need to make your lesson or workshop happen, but in an automated format.

When you’ve assembled your Smartscript anyone can play it. Your lesson plays out on a computer, tablet or smartphone in real-time, animated with your very own video and media content. A smartscript brings lesson and workshops to life through the power of the internet.

What is a Smartscript?

Prospero is an online platform that allows anyone to build and share interactive workshops and lessons on any subject, theme or challenge. Its flexible, easy to use and creative. All you need to access Prospero is a device with a web browser.

What is Prospero?

Prospero works through web browsers. Any device which can access the internet through a browser can use Prospero. That makes it easy to use and accessible.

Anyone can create their own Smartscripts in Prospero using any web browser.

When you want to play a Smartscript, you might need particular technologies in place. In the Prospero Library the requirements for each Smartscript are clearly set out, so you know what you need in advance of using it.

If you’re using Prospero in a classroom or studio space you’ll typically need a PC, Mac or Chromebook. You will need to be running one of two browsers - Chrome or Firefox - as Prospero needs to install a free extension or add-on (approved and authorised by Google and Mozilla) to work effectively.

Some classroom Smartscripts can also use multiple tablets and smartphones to help you organise group work or individual tasks. The Library makes these arrangements clear in advance so you can plan accordingly.

Other Smartscripts run purely on tablets or smartphones, so learning can by personalised or mobile, letting you explore the world around you. Check the Library.

Some Smartscripts are available in different formats - Lite versions have less hardware requirements making them easier to use anywhere. Check the Library.

Because Prospero works through web browsers there is nothing for you to maintain: all software is updated at our end, not yours. Make sure your hardware is up to date with settings compatible with the simple requirements in the Prospero Library.

To find out more about managing these extensions in your web browser, click the relevant link below:

* [Install and manage extension in Chrome](https://support.google.com/chrome_webstore/answer/2664769)
* [Find and install add-ons to add features to Firefox](https://support.mozilla.org/en-US/kb/find-and-install-add-ons-add-features-to-firefox)

What technology do I need to use Prospero?

Control access to specific features for members of your subgroups by setting permissions.

***

## Step 1

Go to `Groups` and expand a subgroup.

## Step 2

Choose the `PERMISSIONS` tab.

## Step 3

If permissions have previously been set, you'll see an overview of those settings. Press `EDIT` to edit permissions.

## Step 4

The permissions form will open in Modules mode, displaying a list of presets to control groups of permissions. A common module to use is the Pro module which gives basic user-level access to smartscript creation, editing and sharing.

Select one of the modules from the list to apply the group of permissions.

## Step 5

To customise permissions further, expand `AdVANCED PERMISSIONS` mode. This displays permissions, grouped by section.

## Step 6

Enable a section in order to show further section sub-permissions, and disable a section to disable access in full for that section.

## Step 7

When you have finished editing permissions, press `SAVE` to save your changes. When members of the subgroup next sign in (or refresh their Prospero session) the new permissions will be activated.

***

**Please note**: The choice of permissions in each section will depend on the permissions set for the parent group. For example, if ParentGroup doesn't allow sharing smartscripts via a direct link, the option won't appear in ChildGroup's permissions form.

An introduction to permissions

If you are a member of multiple groups, the group breadcrumb at the top of the page will appear as a group switcher:

![Group switcher example](https://res.cloudinary.com/candt/image/upload/v1656497484/prospero_v3-docs/group-switcher-example.png)

This pull-down menu allows you to switch between your groups quickly and easily. Once you have switched to a new group, you may notice changes to your dashboard and page access as your account adapts to the permissions of the group.

These permissions may be restrictive, such as restricted access to a group's smartscripts, or more permissive, such as a larger number of tokens or storage quota, for example.

Once switched, your account remembers the group and will keep you signed into that group whenever you use Prospero. You can switch to another group at any time.

**Group creators, please note**: Switching to a group you have created will mean you take on the same permissions as all other members of the group. To expand your permissions, switch to a parent group instead.

Switching groups

There are three levels of access for Prospero producers, and these are used to filter various content throughout Prospero. For example, from filtering Smartscripts on your dashboard:

![Filtering smartscripts](https://res.cloudinary.com/candt/image/upload/v1656498789/prospero_v3-docs/Screenshot_2022-06-29_11.31.49.png)

to filtering media files in your Media library:

![Filtering media](https://res.cloudinary.com/candt/image/upload/v1656498787/prospero_v3-docs/Screenshot_2022-06-29_11.32.48.png)

Depending on your account's permissions, you may only have the User level available, or you might have all three. Here's an overview of each of the levels and what they mean:

## User

*User access* filters items to just your account. If you're a member of a group, or are a producer, filtering by user access will show only the items you have created, and will hide everything else.

## Group

*Group access* filters items to the group you are currently in. If you are in multiple groups, this is the group currently displayed in your group switcher (see related links for more info on this). This level allows you to collaborate or edit other group members' smartscripts.

## Producer

*Producer access* displays all content created in the producer account. This includes all members of all groups, and includes the producer's content - a kind of 'show all' level.

If you have account permissions to create groups, you can allow or deny group member access to these user levels by setting the group's permissions. More info on this can be found in the introduction to permissions below.

User levels in Prospero

Frame smartscripts use named placeholders which are later switched with custom values by an assignment.

***

Placeholders can be text, number or media content such as images or youtube videos. They are added by choosing the placeholder option from specific fields in the smartscript builder. Options to add a placeholder are not available unless the smartscript is contained within a programme flagged as a Frame smartscript container.

## Flagging a programme as a Frame

1. Go to `Smartscripts` on your Dashboard and [create a new smartscript](/help/smartscripts/create-a-new-smartscript).
2. Select the newly created smartscript from the `Drafts` section.
3. From the `Programme settings` menu on the left, select `Details`.
4. At the bottom of the form, switch on `Is a frame`.
5. Press `SAVE` to save your changes. You will see the blue `FRAME` flag appear to the right of your programme title.

Any smartscripts contained or added to this programme will now allow for placeholders to be added.

## Adding media placeholders

1. Edit one of the smartscripts listed in the programme page by pressing `EDIT`.
2. Once the builder has loaded, add or edit one of the following actions and assets:
   * Scenes > Custom scene
   * Actions > Direction
   * Actions > Actor
   * Actions > Soundtrack
   * Characters
3. On any `UPLOAD` field found in a form for one of the above actions or assets, press the right-hand dropdown menu and choose `Placeholder` to add a placeholder.
4. Enter a descriptive name for your placeholder. We recommend you name it based on the kind of data it will be switched with ("Activity 4 photo" or "Character selfie", for example).
5. Choose the kind of media expected from the pulldown list. For soundtracks, only Audio will be available.
6. Press `SAVE`. A custom thumbnail featuring the name of your placeholder will be generated.
7. You can change display optioms, or edit or remove the placeholder from the thre dot media menu.

## Adding text placeholders

1. Edit one of the smartscripts listed in the programme page by pressing `EDIT`.
2. Once the builder has loaded, add or edit one of the following actions and assets:
   * Actions > Direction
   * Actions > Actor
   * Characters
3. Some text fields will feature a `Use a placeholder` link just below it. Press the link to open the placeholder form.
4. Enter a descriptive name for your text placeholder ("Question 4 answer" or "Player name", for example).
5. Press `SAVE`. The text field will now be filled with the name of your placeholder and will not be editable.
6. You change the name of, or remove your placeholder by pressing `Edit placeholder`.

Building a Frame smartscript

Smartscripts can be created from the Smartscripts dashboard and from within a programme.

***

## Creating a smartscript from the dashboard

1. Go to `Smartscripts` to list your shared and draft smartscripts.
2. Press `Create a smartscript` in the `Drafts` section.
3. There will be two tabs available in the popup:
   * Create
   * Transfer
4. `CREATE` is selected by default and will create a new blank smartscript.
5. Enter a title for the smartscript.
6. If you have a Prospero file, you can upload it here (see [What is a Prospero file](/help/smartscripts/what-is-a-prospero-file)).
7. Press `CREATE` to create the smartscript.
8. The smartscript programme will appear in your `Drafts` section.
9. Select the programme, and you'll see it contains the new smartscript with the same title.

## Transferring a programme

1. Go to `Smartscripts` to list your shared and draft smartscripts.
2. Press `Create a smartscript` in the `Drafts` section.
3. Press the `TRANSFER` tab.
4. Paste the code you've been given by another Prospero producer.
5. Press `TRANSFER` to transfer their programme and smartscripts to your account.
6. The smartscript will appear in your `Drafts` section.

***

Selecting a programme from your Smartscripts dashboard takes you to its smartscript listing. From there, you can select `Create a smartscript` to add a smartscript to the programme.

The tabs that appear in this form are different to the one displayed on the main Smartscripts dashboard. There are two new tabs:

* Copy
* Import

## Copying a smartscript

Copying a smartscript involves making a clone of the original smartscript. Any edits made in the new smartscript have no effect on the original.

1. Go to `Smartscripts` to list your shared and draft smartscripts.
2. Select a programme from the list.
3. On the programme's smartscript listing page, press `Create a smartscript`.
4. Press the `COPY` tab.
5. Enter a title for the smartscript.
6. Press `SELECT` to select a smartscript from your shared and draft lists.
7. Press `COPY` to copy the selected smartscript.
8. The new smartscript will appear at the bottom of the programme's list of smartscripts. Drag and drop items to reorder them.

## Importing a smartscript

Importing makes a reference to another smartscriopt, so changes made in one will affect the other.

1. Go to `Smartscripts` to list your shared and draft smartscripts.
2. Select a programme from the list.
3. On the programme's smartscript listing page, press `Create a smartscript`.
4. Select the `IMPORT` tab.
5. Press `SELECT` to select a smartscript from your shared and draft lists.
6. Press `IMPORT` to import the selected smartscript.
7. The imported smartscript will appear at the bottom of the programme's list of smartscripts. Drag and drop items to reorder them.

Creating a new smartscript

Prospero files hold all data required to rebuild a smartscript, a programme of smartscripts or an assignment of smartscripts.

***

The files can be generated and downloaded from any smartscript or assignment, in the '.json' format. These files can then be uploaded when creating a programme, smartscript or assignment.

## Generating and using a Prospero file from a smartscript

1. Go to the `Smartscripts` dashboard.
2. Select the programme from the list.
3. In the programme's smartscript listing, press the three dot menu for the smartscript you wish to download.
4. Choose `Download` from the popup menu.
5. The Prospero file will be generated and downloaded as `name-of-smartscript.json`.

### To use file

1. Go to either the `Smartscripts` dashboard, or select a programme from the dashboard to view the list of smartscripts.
2. Press `Create a smartscript`.
3. Enter a title.
4. Press `Have a Prospero file?`.
5. Select `UPLOAD PROSPERO FILE` and choose the Prospero `.json` file you wish to upload.
6. Press `CREATE` to create the smartscript.

## Generating and using a Prospero file from an assignment

Assignment Prospero files include not only the assignment, but also all smartscript data, frame smartscript data and destination programme data (if applicable).

1. Go to the `Assignments` dashboard.
2. Press the three-dot menu on the assignment you wish to download.
3. Choose `Download` from the popup menu.
4. The Prospero file will be generated and downloaded as `name-of-assignment.json`.

### To use file

1. Go to `Assignments` dashboard.
2. Press `Add a new assignment`.
3. Enter a title.
4. Press `Have a Prospero file?`.
5. Select `UPLOAD PROSPERO FILE` and choose the Prospero `.json` file you wish to upload.
6. Press `SAVE` to add the assignment and generate the related smartscripts.