Installing Origami (Using App Catalog)

[origami]

You will need to log in as SharePoint Admin for this.

1. Log in to your Microsoft 365 admin center page as SharePoint Admin

2. Click on the SharePoint admin center link as shown below:
   

3. In the left-hand side navigation click on More Features.
   

4. From the list on the page, click the Open button under the Apps.
   

   
   
   This will open your SharePoint App Catalog.

5. Your Origami account manager sent you an installation package (about 30 files with *.sppkg extension). Download these SPFX packages to your computer and then upload each of them to the App Catalog, one by one.

6. For each of the files you upload, wait for the following confirmation to come up and select one of two options:
   

   

Which option do you select?

• Only enable this app - let Origami be used only on some sites and not the whole organization.
• Enable this app and add it to all sites - let the whole organization use Origami.

7. Click Enable app button and wait for completion.

8. Repeat steps 5-7 for each of the files one by one in the package provided.

NOTE: After you enable some apps, you might be asked to [Set up an API permission]. This step can be skipped by clicking the [I’ll do it later] button. Additional permissions can be given on an as-needed basis later.

Enabling Origami on selected sites

This applies only if you opted to use Origami on some sites and not the whole organization (if you selected Only enable this app in step 6 in the sequence above).

1. Go to the site collection on which you’d like to enable Origami.
2. Click [*] → Add an app
   
   
3. Under the Apps you can add, click Add for each of the Origami apps you’d like to enable.
   
   

Now your page authors can add this web part to pages as shown in the Getting Started video

Unable to upload to your SharePoint App Catalog?

If you’re unable to complete the sequence above because you don’t see the Upload button in your App Catalog, then follow the steps below:

1. Navigate to the SharePoint admin center.
   

   

2. In the left-hand side navigation click on the Sites → Active Sites link.

3. Search for the URL of your App Catalog.
   

   

4. Click on the title of the app catalog site.

5. In the flyout window, select the [Permissions] tab and add your username as an Admin in the list.

Optional site configuration for legacy web parts

If you’re using an installation package released prior to June 2023, you’ll need to do these additional installation steps.

1. Navigate to the site which will be your intranet home page.
2. Create a new list Custom List and give it a name [Config].
   Here is how to create a SharePoint list → Create a list - Microsoft Support
3. Add a new list column called [Value]. The type of the column should be a Single line of text
4. The minimum values required in the list are:
   5.1 Title: PrimaryColour Value: [hex of your primary color; example: #385d7f]
   4.2 Title: SecondaryColour Value: [hex of your secondary color; example: #e18719]
   4.3 Title: origamirootsiteindicatorkey2019 Value: origamirootsiteindicatorkey2019