

# Administer your SiteWise Monitor portals
Administer your portals

**Note**  
The SiteWise Monitor feature is no longer available to new customers. Existing customers can continue to use the service as normal. For more information, see [SiteWise Monitor availability change](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).

You have the ability to manage and configure various aspects of the portal. This includes adding and removing users or administrators, setting user permissions and roles, customizing the portal's URL, name, setting a support contact information, and sending email invitations to portal administrators. 

1. Sign in to the [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/home).

1. In the navigation pane, choose **Monitor**, **Portals**.  
![\[Left navigation pane in the AWS IoT SiteWise console with Portals highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/sitewise-choose-portals-console.png)

1. Choose a portal, and then choose **View details** (or choose the portal's **Name**).

1. You can perform any of the following administrative tasks:
   + [Change portal details in AWS IoT SiteWise](portal-change-details.md)
   + [Add or remove portal administrators in AWS IoT SiteWise](portal-change-admins.md)
   + [Send email invitations to portal administrators](send-email-invitations-to-portal.md)
   + [Add or remove portal users in AWS IoT SiteWise](portal-change-users.md)
   + [Delete a portal in AWS IoT SiteWise](portal-delete-portal.md)

For information about how to create a portal, see [Get started with AWS IoT SiteWise Monitor (Classic)](monitor-getting-started.md).

**Topics**
+ [

# Change portal details in AWS IoT SiteWise
](portal-change-details.md)
+ [

# Add or remove portal administrators in AWS IoT SiteWise
](portal-change-admins.md)
+ [

# Send email invitations to portal administrators
](send-email-invitations-to-portal.md)
+ [

# Add or remove portal users in AWS IoT SiteWise
](portal-change-users.md)
+ [

# Delete a portal in AWS IoT SiteWise
](portal-delete-portal.md)

# Change portal details in AWS IoT SiteWise
Change a portal's attributes

**Note**  
The SiteWise Monitor feature is no longer available to new customers. Existing customers can continue to use the service as normal. For more information, see [SiteWise Monitor availability change](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).

You can change a portal's name, description, branding, support email, and permissions.

1. On the portal details page, in the **Portal details** section, choose **Edit**.  
![\[Portal details section of the portal details page with Edit highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/sitewise-view-portal-details-console.png)

1. Update the **Name**, **Description**, **Portal branding**, **Support contact email**, or **Permissions**.

1. When you're finished, choose **Save**.

# Add or remove portal administrators in AWS IoT SiteWise
Add or remove portal administrators

**Note**  
The SiteWise Monitor feature is no longer available to new customers. Existing customers can continue to use the service as normal. For more information, see [SiteWise Monitor availability change](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).

In a few steps, you can add or remove users as administrators for a portal. Based on the user authentication service, choose one of the following options.

------
#### [ IAM Identity Center ]

![\[Portal administrators section of the portal details page.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/SSOAdminDetail.png)


**To add portal administrators**

1. On the portal details page, in the **Portal administrators** section, choose **Assign administrators**.

1. On the **Assign administrators** page, select the check boxes for the users to add to the portal as administrators.
**Note**  
If you use IAM Identity Center as your identity store, and you're signed in to your AWS Organizations management account, you can choose **Create user** to create an IAM Identity Center user. IAM Identity Center sends the new user an email for them to set their password. You can then assign the user to the portal as an administrator. For more information, see [Manage identities in IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-identity-source-sso.html).

1. Choose **Assign administrators**.

![\[The "Assign administrators" page.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/SSOAdminAssign.png)


**To remove portal administrators**
+ On the portal details page, in the **Portal administrators** section, select the check box for each user to remove, and then choose **Remove from portal**.
**Note**  
We recommend that you select at least one portal administrator.

------
#### [ IAM ]

![\[Portal administrators section of the portal details page.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/IAMAdminDetail.png)


**To add portal administrators**

1. On the portal details page, in the **Portal administrators** section, choose **Assign administrators**.

1. On the **Assign administrators** page, do the following:
   + Choose **IAM users**, if you want to add an IAM user as your portal administrator.
   + Choose **IAM roles**, if you want to add an IAM role as your portal administrator.

1. Select the check boxes for the users or roles that you want as your portal administrators. This adds the users or roles to the **Portal administrators** list.

1. Choose **Assign administrators**.

**Important**  <a name="iam-portal-user-permissions"></a>
Users or roles must have the `iotsitewise:DescribePortal` permission to sign in to the portal.

![\[The "Assign administrators" page.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/IAMUserAdminAssign.png)


![\[The "Assign administrators" page.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/IAMRoleAdminAssign.png)


**To remove portal administrators**
+ On the portal details page, in the **Portal administrators** section, select the check box for each user to remove, and then choose **Remove from portal**.
**Note**  
Leaving a portal without a portal administrator is not recommended.

------

# Send email invitations to portal administrators


**Note**  
The SiteWise Monitor feature is no longer available to new customers. Existing customers can continue to use the service as normal. For more information, see [SiteWise Monitor availability change](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).

You can send email invitations to portal administrators.

1. On the portal details page, in the **Portal administrators** section, select the check boxes for the portal administrators.  
![\[Portal administrators section of the portal details page with "Send invitations" highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/sitewise-select-portal-administrator-console.png)

1. Choose **Send invitations**. Your email client opens, and an invitation is populated in the message body.

   You can customize the email before you send it to your portal administrators.

# Add or remove portal users in AWS IoT SiteWise
Add or remove portal users

**Note**  
The SiteWise Monitor feature is no longer available to new customers. Existing customers can continue to use the service as normal. For more information, see [SiteWise Monitor availability change](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).

You choose which users have access to your portals. Portal users appear in the list of users within a SiteWise Monitor portal. From this list, portal administrators can add project owners, and project owners can add project viewers.

**Note**  
Your portal administrators and portal users might contact you through a portal's support email if they need you to add or remove a user.

Based on the user authentication service, choose one of the following options.

------
#### [ IAM Identity Center ]

![\[Portal administrators section of the portal details page.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/SSOUserDetail.png)


**To add portal users**

1. On the portal details page, in the **Portal users** section, choose **Assign users**.

1. On the **Assign users** page, select the check box for the users to add to the portal.
**Note**  
If you use IAM Identity Center as your identity store, and you're signed in to your AWS Organizations management account, you can choose **Create user** to create an IAM Identity Center user. IAM Identity Center sends the new user an email for them to set their password. You can then assign the user to the portal as a user. For more information, see [Manage identities in IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-identity-source-sso.html).

1. Choose **Assign users**.

![\[The "Assign users" page.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/SSOUserAssign2.png)


**To remove portal users**
+ On the portal details page, in the **Portal users** section, select the check box for the users to remove from the portal, and then choose **Remove from portal**.

------
#### [ IAM ]

![\[Portal administrators section of the portal details page.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/IAMRoleUserDetail.png)


**To add portal users**

1. On the portal details page, in the **Portal users** section, choose **Assign users**.

1. On the **Assign users** page, do the following:
   + Choose **IAM users** to add an IAM user as your portal user.
   + Choose **IAM roles** to add an IAM role as your portal user.

1. Select the check boxes for the users or roles that you want to add as your portal users. This adds the users or roles to the **Portal users** list.

1. Choose **Assign users**.

![\[The "Assign users" page.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/IAMUserAssign2.png)


![\[The "Assign users" page.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/IAMRoleAssign2.png)


**To remove portal users**
+ On the portal details page, in the **Portal users** section, select the check box for the users to remove from the portal, and then choose **Remove from portal**.

**Important**  <a name="iam-portal-user-permissions"></a>
Users or roles must have the `iotsitewise:DescribePortal` permission to sign in to the portal.

------

# Delete a portal in AWS IoT SiteWise
Delete a portal

**Note**  
The SiteWise Monitor feature is no longer available to new customers. Existing customers can continue to use the service as normal. For more information, see [SiteWise Monitor availability change](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).

You might delete a portal if you created it for testing purposes or if you created a duplicate of a portal that already exists.

**Note**  
You must first manually delete all dashboards and projects in a portal before you can delete a portal. For more information, see [Deleting projects](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/delete-projects.html) and [Deleting dashboards](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/delete-dashboards.html) in the *SiteWise Monitor Application Guide*.

1. On the portal details page, choose **Delete**.
**Important**  
When you delete a portal, you lose all projects that the portal contains, and all dashboards in each project. This action can't be undone. Your asset data isn't affected.  
![\[Portal details page with Delete highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/sitewise-delete-portal-console.png)

1. In the **Delete portals** dialog box, choose **Remove admins and users**.

   You must remove the administrators and users from a portal before you can delete it. If your portal doesn't have administrators or users, the button doesn't appear, and you can skip to the next step.  
![\["Delete portals" dialog box with "Remove administrators and users" highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/sitewise-delete-portal-remove-users-console.png)

1. If you're sure that you want to delete the entire portal, enter **delete** in the field to confirm deletion.  
![\["Delete portals" dialog box with "Delete" highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/userguide/images/sitewise-delete-portal-confirm-delete-console.png)

1. Choose **Delete**.