# Portal Pages Portal pages contain one or more portal widgets. Each widget on a portal page can be resized and may accept properties to configure the widget's behavior. Widget's are self contained UI elements that provide features without the need to write code. ## Creating a Page You can create a portal page by navigating to Portal \ Pages in the Admin Console's menu. Next, click Create New Portal Page. ## Editing a Page Click the view button for the page in order to begin editing the content of the page. Once viewing the page, you can click Edit to enter edit mode.

### Adding Widgets To add an UI element to the page, click Add Widget to select from a list of Widgets to add to the page.

If you do not have widgets shown in the modal, you can add pre-made ones to your environment using the [library](/platform/library.md). Once you find the Portal Widget to add, click the Add button under the description.

Doing so will add the Portal Widget to the page.

### Configuring Portal Widgets Portal Widgets can contain properties that change the behavior of the UI element. In most cases, a default value will be defined so a UI element is shown. Click the Properties button to view the properties for the widget. All widgets have a height and width property that can be set. By default, the widget will span 100% of the page and take up as much height as is necessary to show the content of the widget.

### Positioning Portal Widgets Portal Pages use a grid system to lay out Portal Widgets. Each row has 12 possible columns. You can use the widget's width property to define how many of the columns the widget will span. For example, you can place 2 widgets side by side by setting both of their widths to 6.

You can use the positional buttons on the button of the Portal Widget card to move the widget between rows and change the order of the columns.

The blue border around the widgets indicates their size and position. The outer blue border is representative of the row the widgets are currently positioned in. The inner blue border is the size and position of the widget itself. ### Saving a Page Once you have completed your changes to the contents of the page. Click the Save button to persist any changes to the Repository. ## Role-Based Access Pages can be assigned to users based on their role. Use the Page's properties to assign these roles. Users with the Pages assigned will see the pages on their Portal. ## Permissions Permission related to pages. See [Permissions ](/security/enterprise-security/permissions.md)for information on how these values are used. | Identifier | Description | | -------------- | ------------------------------------------------------------ | | portal | Configuration access to the Portal, Portal Pages and Widgets | | portal.pages | Configuration access to Portal Pages | | portal.widgets | Configuration access to Portal Widgets | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.powershelluniversal.com/portal/portal-pages.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.