# Dashboard Configuration The main settings for the dashboard configuration (from Forma 3.x onwards) are available under: *Admin > System configuration > Dashboard Configuration* [![image.png](https://docs2.formalms.org/uploads/images/gallery/2024-01/scaled-1680-/zI2image.png)](https://docs2.formalms.org/uploads/images/gallery/2024-01/zI2image.png) You can **create** a new dashboard or: - Clone/Duplicate - Edit an existing layout - Assign view permissions for each dashboard layout - Delete an existing layout ## Creating a new dashboard [![image.png](https://docs2.formalms.org/uploads/images/gallery/2024-01/scaled-1680-/bbSimage.png)](https://docs2.formalms.org/uploads/images/gallery/2024-01/bbSimage.png) - Dashboard name: Name of the dashboard. It's just for internal purposes, it's not visible to the users. - Dashboard layout caption. This is the caption that appears when you hover on the dashboard button. - Select a status: Draft/Published. ## Duplicating a layout [![image.png](https://docs2.formalms.org/uploads/images/gallery/2024-01/scaled-1680-/xPrimage.png)](https://docs2.formalms.org/uploads/images/gallery/2024-01/xPrimage.png) Duplicate an existing layout and set its Name, Description, and status ## Editing a layout ### Adding a new block You can delete blocks using the 'X' button, or you can create new blocks: [![image.png](https://docs2.formalms.org/uploads/images/gallery/2024-01/scaled-1680-/u7Qimage.png)](https://docs2.formalms.org/uploads/images/gallery/2024-01/u7Qimage.png) The available blocks are: - Ads/Announcements: this block displays a list of announcements from the courses the user is enrolled to. - Image / video banner: this block adds an image banner, that can be linked to a video opening in a popup. - Calendar: this block displays courses start/end dates and classroom days on a calendar layout - Certificates: this block displays a list of the latest certificate available to users - Courses: this block displays the next courses about to start or close or classroom days. - Messages: this displays a list of private messages received by the user - Welcome message: this block sets a custom welcome message on the dashboard page. If you don't set a custom message, the default one from the languages will be used. Concerning the welcome message, we recommend using and/or customizing the default text in the language management, because it can include the user's first and last name, and it can be localized according to the user's preferred language. ### Editing blocks For each block, you can set: - Type: Number of columns - Title: a title that will be displayed to users - Specific parameters for each block **Block width and position** The dashboard layout is based on a grid of 4 columns: - **Width**: each block will occupy a variable width of 1 to 4 columns, for a maximum of 4 columns occupied on the same row - **Position**: Every block can be dragged and dropped horizontally or vertically. [![image.png](https://docs2.formalms.org/uploads/images/gallery/2024-01/scaled-1680-/7ZUimage.png)](https://docs2.formalms.org/uploads/images/gallery/2024-01/7ZUimage.png) ## Viewing Permissions Set the users, nodes or groups assigned to view each layout: with this feature you will be able to assign different dashboard layouts to different users. ## Example This is a good example [![image.png](https://docs2.formalms.org/uploads/images/gallery/2024-01/scaled-1680-/ybhimage.png)](https://docs2.formalms.org/uploads/images/gallery/2024-01/ybhimage.png) Let's see how it's configured in the backend. On the first row, two blocks of 2 columns each. The Welcome message has been customized here, so this will override whatever message is in the language management. The banner is 600 × 120, and it's linked to a YT video. You can also use slightly different sizes: in general, the banner should have a rectangular ratio. [![image.png](https://docs2.formalms.org/uploads/images/gallery/2024-01/scaled-1680-/lisimage.png)](https://docs2.formalms.org/uploads/images/gallery/2024-01/lisimage.png) Let's see the second row: three blocks, the calendar has 2 columns and the other blocks have 1 each. [![image.png](https://docs2.formalms.org/uploads/images/gallery/2024-01/scaled-1680-/AsHimage.png)](https://docs2.formalms.org/uploads/images/gallery/2024-01/AsHimage.png)