Use a PnP provisioning template

Add a Microsoft PnP provisioning template to a team or SharePoint site template, so every workspace you provision gets the owners, members, channels and settings it defines. PnP (Patterns and Practices) is a Microsoft and community initiative that provides templates and tools for Microsoft 365, including the PnP provisioning schema.

Before you begin

• Your Rencore role includes the Edit Provisioning permission. Owner, Admin and Contributor have it. See Rencore roles.
• Provisioning is part of the Premium and Enterprise Plans.
• You have a PnP template saved as an XML file. A basic example is shown under Example PnP template below.
• PnP templates work with team templates and SharePoint site templates. Microsoft 365 group, Planner and Viva Engage templates have no PnP setting.

Steps

1. Upload the PnP template to your library, then add it to a provisioning template, as described below.

Upload the PnP template

1. Click Provisioning on the Nav Panel.

2. Click Manage Provisioning Templates.

3. Click the Ellipse menu ([…]) in the top-right corner.

4. Select Edit managed entities.

5. Select PnP Templates.

6. Click + Add.

   

7. Click Browse.

8. Go to the .pnp template file, select it, and click Open.

9. Enter a Display Name and a Description for the template.

10. Click Save.

<figure><img alt="Insert New Record panel with display name, description and the uploaded PnP file, Save highlighted" src="/images/docs/idApYnOqhGR397BibJAu.png"></figure>

Add the PnP template to a provisioning template

1. Open the team or SharePoint site template in the template builder.
2. Go to 2. Provisioning Settings.
3. In the PnP Template section, turn on Use custom template.
4. In Custom PnP Template, select the PnP template you uploaded.
5. Save the template.

Example PnP template

With a PnP template, you can force some actions without showing them in the provisioning template. This example always adds certain people as owners and members, and adds a standard and a private channel:

<?xml version="1.0" encoding="utf-8"?>
<pnp:Provisioning xmlns:pnp="http://schemas.dev.office.com/PnP/2022/09/ProvisioningSchema"
    Author="Your name"
    Description="Example Provisioning Template for Teams"
    DisplayName="Teams Provisioning">
    <pnp:Teams>
    <!-- Displayname, Description and Visibility will be taken from Rencore Governance settings and not be changed to your template settings-->
        <pnp:Team DisplayName="Placeholder" Description="Placeholder" Visibility="Private">
            <pnp:Security>
                <pnp:Owners>
                    <pnp:User UserPrincipalName="[email protected]"/>
                </pnp:Owners>
                <pnp:Members>
                    <pnp:User UserPrincipalName="[email protected]"/>
                </pnp:Members>
            </pnp:Security>
            <pnp:Channels>
                <pnp:Channel
                    DisplayName="General"
                    Description="General">
                </pnp:Channel>
                <pnp:Channel
                    DisplayName="Standard Channel"
                    Description="This is just a standard channel">
                </pnp:Channel>
                <pnp:Channel
                    DisplayName="Secret Channel"
                    Description="This is a private channel"
                    MembershipType="Private">
                </pnp:Channel>
            </pnp:Channels>
        </pnp:Team>
    </pnp:Teams>
</pnp:Provisioning>

The display name, description and visibility are taken from the Rencore Governance settings, not from the PnP template.

What you can do with a PnP template

• Add certain users as members or owners
• Add standard and private channels
• Add apps and tabs to a channel
• Change settings, and more

Limits

PnP does not support the creation of shared channels yet.