---
title: "Install Document Converter for SharePoint Online"
canonical_url: "https://www.nutrient.io/guides/document-converter/sharepoint/knowledge-base/installing-the-pdf-converter-for-sharepoint-online-app/"
md_url: "https://www.nutrient.io/guides/document-converter/sharepoint/knowledge-base/installing-the-pdf-converter-for-sharepoint-online-app.md"
last_updated: "2026-05-15T19:10:04.948Z"
description: "Follow this guide to install Nutrient Document Converter for SharePoint (Online) (previously Muhimbi Document Converter for SharePoint Online) SPFx and transition from SharePoint Add-Ins before April 2026."
---

# Install Document Converter for SharePoint

Microsoft retired SharePoint Add-Ins on 1 July 2024, so you can no longer acquire them from the public marketplace.

Nutrient Document Converter for SharePoint (Online) uses a SharePoint Framework (SPFx) web part and extension with Microsoft Entra ID authentication.

Use this guide to deploy the SPFx app in your SharePoint Online tenant.

## Prerequisites before deployment

Before you deploy the Nutrient SharePoint Framework extension, confirm that you have:

- Global administrator privileges in your SharePoint Online tenant (or tenant administrator privileges).

- Administrator privileges on your Windows machine to run the installer script.

- Execution policy for external scripts set in your PowerShell session:
  `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force`

- An app catalog in your tenant. If you don’t have one, refer to the [create an app catalog](https://learn.microsoft.com/en-us/sharepoint/use-app-catalog) guide.

## Installation files

Download the [installation script](https://buy.nutrient.io/Images---Files/Support-Files/PDFConverterForSPOnlineInstallationScript.ps1.zip.aspx) and [application package](https://buy.nutrient.io/Images---Files/Support-Files/muhimbi-pdf-converter-spfx-app.sppkg.zip.aspx). Place both files in the same folder.

## Step 1: Register the Entra ID app

Open PowerShell 7 as an administrator, go to the folder that contains the files, and run `PDFConverterForSPOnlineInstallationScript.ps1`.![PowerShell installer script menu for Document Converter](@/assets/guides/muhimbi/pdf-converter/spfx-installer/image-1.png)

The script shows 17 options.

### Option A: Generate a new certificate (recommended)

If this is your first setup, use option 16:

1. Press `16` to register an Entra ID app with a new certificate.

2. Enter the application name, or press Enter to use the default: `PnPPowerShellAppForSPFxInstallation(Nutrient)`.

3. Enter your Entra tenant domain (for example, `yourcompany.onmicrosoft.com`).

4. Enter a password for the certificate.

5. Authenticate to your Microsoft 365 tenant when prompted.

6. Grant consent on behalf of your organization.

7. The script creates a new certificate in the same folder and registers the Entra ID app.

8. The script displays the client ID and tenant ID in PowerShell.

### Option B: Use an existing certificate

If you already have a `.pfx` certificate, use option 17:

1. Press `17` to register by using an existing certificate.

2. Provide the full path to your `.pfx` certificate file.

3. Enter the certificate password.

4. Authenticate to your Microsoft 365 tenant when prompted.

5. Grant consent on behalf of your organization.

6. The script registers a new Entra ID app by using the certificate you provided.

7. The script displays the client ID and tenant ID in PowerShell.

**Save these values** — After registration, save the application (client) ID, tenant domain, and certificate path. The script stores these values only for the current PowerShell session.

### Option C: Use an existing Entra ID app

If you already registered an Entra ID app, press `15` and provide the client ID when prompted.

## Step 2: Install the SPFx app

After you register the Entra ID app, install the SPFx app.

1. Press `1` to run a fresh installation.

2. Choose the upload location:
   - Press `1` for the tenant app catalog (recommended). The script doesn’t deploy to all sites automatically; it asks in the next step.
   - Press `2` for a site app catalog (single-site deployment).

3. Enter your SharePoint URL:
   - Tenant: `https://yourcompany.sharepoint.com`
   - Site: `https://yourcompany.sharepoint.com/sites/yoursite`

4. When prompted with “Do you want to deploy the app to all sites in the tenant?” select:
   - `[Y]` for tenant-wide deployment
   - `[N]` for site-specific deployment\
     If you select `N`, the script asks whether to install on a specific site collection.![Tenant-wide deployment prompt in the installer](@/assets/guides/muhimbi/pdf-converter/spfx-installer/image-2.png)

5. After installation on a site collection, the script asks:

   “Do you want to create a page and add the Muhimbi Features web part to this site collection?”

   - Select `[Y]` to add the web part. The script creates a page in the Site Pages library and adds the web part.
   - Select `[N]` if you want to add the web part later. You can add it later by pressing `2` when you run the script.![Prompt to add the Muhimbi Features web part to a site collection](@/assets/guides/muhimbi/pdf-converter/spfx-installer/image-3.png)

6. Approve API permissions in SharePoint Admin Center, if prompted:
   - Go to `https://<yourtenant>-admin.sharepoint.com/_layouts/15/online/AdminHome.aspx#/webApiPermissionManagement`.

   - Grant the required permissions.
   - A global administrator must complete this step.

7. Elevate app permissions in the site collection and enable custom scripting:
   - Press `8` to elevate permissions.
   - When prompted to enable custom scripts, select `[Y]`.
   - The web part requires custom scripts. You can also enable it later by pressing `12` when you run the script.
   - The web part won’t work until you enable custom scripts.![Elevate permissions and enable custom scripts prompt](@/assets/guides/muhimbi/pdf-converter/spfx-installer/image-4.png)

   The application is now installed.

8. Verify the installation:
   - Go to the **Site Contents** page for the site collection where you installed the app.
   - Confirm that the Muhimbi PDF Converter SPFx app (now Nutrient Document Converter) appears in the list.

9. Use the **Convert to PDF** action in document libraries:
   - Select a document.
   - Click **Convert to PDF** in the list view command set or content menu.![Convert to PDF action in a SharePoint document library](@/assets/guides/muhimbi/pdf-converter/spfx-installer/image-5.png)

   - The first time you use **Convert to PDF**, the script prompts you to authenticate and grant permissions for SharePoint access.
   - A global administrator should complete this step.![Authentication and permissions prompt for the app](@/assets/guides/muhimbi/pdf-converter/spfx-installer/image-6.png)

10. If this is a new tenant, after you grant permissions, the app prompts you to start a trial.
    After signing up, you’ll receive a confirmation email to activate the trial.![Trial sign-up prompt for new tenants](@/assets/guides/muhimbi/pdf-converter/spfx-installer/image-10.png)![Confirmation email to activate the trial](@/assets/guides/muhimbi/pdf-converter/spfx-installer/image-11.png)

After activation, you can convert, secure, watermark, and merge documents in the SharePoint interface.
---

## Related pages

- [How to resolve the issue of Blink binaries (Portable Chromium) no longer being included?](/guides/document-converter/sharepoint/knowledge-base/alternative-options-to-portable-chromium.md)
- [Understanding automatic check-in for SharePoint Online](/guides/document-converter/sharepoint/knowledge-base/automatic-check-in-behaviour-in-sharepoint-online.md)
- [Understanding file check-in and checkout in SharePoint](/guides/document-converter/sharepoint/knowledge-base/are-files-checked-in-out-after-conversion.md)
- [Streamline document conversion in SharePoint](/guides/document-converter/sharepoint/knowledge-base/automatic-document-conversion-workflow-getting-started.md)
- [How to avoid Microsoft Office as a dependency?](/guides/document-converter/sharepoint/knowledge-base/avoiding-microsoft-office-as-dependency.md)
- [What do I get if I subscribe to Document Converter Online?](/guides/document-converter/sharepoint/knowledge-base/difference-between-sharepoint-app-and-power-automate-features.md)
- [Effortlessly convert SharePoint list items to PDF](/guides/document-converter/sharepoint/knowledge-base/convert-a-list-item-including-all-attachments-to-pdf.md)
- [Configuring Chromium-based HTML-to-Document converter](/guides/document-converter/sharepoint/knowledge-base/configuring-chromium-based-html-to-pdf-converter.md)
- [Converting InfoPath/Nintex form-based list items using Nutrient Document Converter](/guides/document-converter/sharepoint/knowledge-base/converting-infopath-nintex-forms-based-list-items-using-the-muhimbi-pdf-converter.md)
- [Effortless document workflows with SharePoint Designer](/guides/document-converter/sharepoint/knowledge-base/creating-workflows-using-sharepoint-designer-the-muhimbi-pdf-converter.md)
- [How to enable custom scripts in SharePoint Online](/guides/document-converter/sharepoint/knowledge-base/enable-custom-scripts-in-sharepoint-online.md)
- [How to specify which InfoPath view(s) to convert?](/guides/document-converter/sharepoint/knowledge-base/how-can-i-specify-which-infopath-view-s-to-convert.md)
- [Elevate App Privileges to Access Advanced Features (Old Version)](/guides/document-converter/sharepoint/knowledge-base/elevate-app-privileges-old-version.md)
- [Deploying real-time watermarking in SharePoint](/guides/document-converter/sharepoint/knowledge-base/enabling-real-time-watermarking-on-modern-view-libraries.md)
- [How can I request a trial license?](/guides/document-converter/sharepoint/knowledge-base/how-can-i-request-a-trial-license.md)
- [How to harden and secure the server running the Conversion Service?](/guides/document-converter/sharepoint/knowledge-base/hardening-securing-the-server-that-runs-the-conversion-service.md)
- [Optimize Nintex workflows with document conversion](/guides/document-converter/sharepoint/knowledge-base/how-can-i-use-the-pdf-converter-in-combination-with-nintex-workflow.md)
- [How does Document Converter handle InfoPath XSN files?](/guides/document-converter/sharepoint/knowledge-base/how-does-the-pdf-converter-deal-with-infopath-xsn-files.md)
- [Secure document processing for SharePoint Online](/guides/document-converter/sharepoint/knowledge-base/how-does-the-pdf-converter-for-sharepoint-online-deal-with-private-documents.md)
- [Find your SharePoint Online Tenancy ID in minutes](/guides/document-converter/sharepoint/knowledge-base/how-to-determine-your-sharepoint-online-tenancy-id.md)
- [How to edit the Conversion Service configuration file?](/guides/document-converter/sharepoint/knowledge-base/how-to-edit-the-conversion-service-s-configuration-file.md)
- [How can I use the GdPicture Conversion Engine globally?](/guides/document-converter/sharepoint/knowledge-base/how-to-use-gdpicture-conversion-engine-globally.md)
- [Knowledge Base: SharePoint Document Converter](/guides/document-converter/sharepoint/knowledge-base.md)
- [Unlock advanced features in SharePoint Document Converter](/guides/document-converter/sharepoint/knowledge-base/how-to-elevate-app-privileges-to-access-advanced-features.md)
- [How to resolve the issue of iFrame, Embed, and Object entities being automatically removed?](/guides/document-converter/sharepoint/knowledge-base/iframe-embed-object-entities-are-removed.md)
- [How well does Document Converter scale and handle high load?](/guides/document-converter/sharepoint/knowledge-base/how-well-does-the-pdf-converter-scale-deal-with-high-load.md)
- [How to install and configure Ghostscript for PDF post-processing](/guides/document-converter/sharepoint/knowledge-base/installing-and-configuring-ghostscript-for-pdf-post-processing.md)
- [Optimize PDFs with advanced OCR features](/guides/document-converter/sharepoint/knowledge-base/ocr-facilities-provided-by-the-pdf-converter.md)
- [FAQs on SharePoint Online Document Converter](/guides/document-converter/sharepoint/knowledge-base/pdf-converter-for-sharepoint-online-faq.md)
- [Set up document converter for SharePoint workflows](/guides/document-converter/sharepoint/knowledge-base/installing-the-pdf-converter-for-sharepoint-online-workflow-actions.md)
- [Deploying Muhimbi Document Converter in SharePoint 2013](/guides/document-converter/sharepoint/knowledge-base/installing-wsp-in-sharepoint-2013-running-2010-legacy-mode.md)
- [Office 2019 Compatibility with Muhimbi Document Converter](/guides/document-converter/sharepoint/knowledge-base/office-2019-compatibility-with-pdf-converter.md)
- [Document Converter in SharePoint Subscription Edition and the stsadm command](/guides/document-converter/sharepoint/knowledge-base/pdf-converter-in-sharepoint-subscription-edition-and-the-stsadm-command.md)
- [or](/guides/document-converter/sharepoint/knowledge-base/print-quality-configuration.md)
- [Effortlessly deploy SharePoint Online apps and extensions](/guides/document-converter/sharepoint/knowledge-base/programmatically-deploy-the-sharepoint-online-app-spfx-extension-and-workflow-actions-to-multiple-site-collections.md)
- [Optimize SharePoint with K2 Workflow Document Converter](/guides/document-converter/sharepoint/knowledge-base/using-pdf-converter-in-combination-with-k2-workflows.md)
- [How to set GdPicture OCR as the default OCR engine?](/guides/document-converter/sharepoint/knowledge-base/set-up-gdpictureocr-as-default-ocr-engine.md)
- [Optimize PDFs: Fast Web Views and font management](/guides/document-converter/sharepoint/knowledge-base/set-pdf-version-enable-fast-web-views-embed-strip-fonts-using-web-services.md)
- [Optimize PDF viewer preferences effectively](/guides/document-converter/sharepoint/knowledge-base/setting-pdf-viewer-preferences-using-the-web-service.md)
- [Convert SharePoint Online pages to PDF easily](/guides/document-converter/sharepoint/knowledge-base/sharepoint-online-html-conversion-user-credentials.md)
- [Streamline PDF conversions in SharePoint Online](/guides/document-converter/sharepoint/knowledge-base/using-the-pdf-converter-for-sharepoint-online-user-interface.md)
- [Upgrade to Muhimbi Document Converter for SharePoint](/guides/document-converter/sharepoint/knowledge-base/upgrading-to-pdf-converter-for-sharepoint-online-spfx.md)
- [Using the Document Converter from PowerShell](/guides/document-converter/sharepoint/knowledge-base/using-the-pdf-converter-from-powershell.md)
- [Where to find details about Document Converter's object model?](/guides/document-converter/sharepoint/knowledge-base/where-can-i-find-details-about-the-pdf-converter-s-object-model.md)
- [What features have been added to Document Converter over the years?](/guides/document-converter/sharepoint/knowledge-base/what-features-have-been-added-to-the-pdf-converter-over-the-years.md)
- [Effortless PDF merging with SharePoint tools](/guides/document-converter/sharepoint/knowledge-base/what-pdf-merging-facilities-are-available.md)
- [Convert various file formats to PDF easily](/guides/document-converter/sharepoint/knowledge-base/what-file-formats-types-are-supported-for-conversion.md)
- [Convert documents with SharePoint PDF converter](/guides/document-converter/sharepoint/knowledge-base/what-locations-can-i-convert-documents-to.md)
- [Watermark and secure OnOpen in SharePoint Online FAQ](/guides/document-converter/sharepoint/knowledge-base/watermark-secure-onopen-in-sharepoint-online-faq.md)
- [Where can I download the latest version of the software?](/guides/document-converter/sharepoint/knowledge-base/where-can-i-download-the-latest-version-of-the-software.md)