--- title: "Create and Edit a Board in an Application" slug: "create-edit-board-application" description: "Learn how to create and customize Boards with various widgets, icons, and colors for effective data interaction and organization." tags: ["applications", "Board Creation", "boards", "collaborating on pigment", "create edit board in an app", "Importing Exporting Data", "Reporting Data visualization", "Security Permissions", "User Interface", "Widgets"] updated: 2025-10-13T16:03:49Z published: 2025-10-13T16:03:49Z --- > ## Documentation Index > Fetch the complete documentation index at: https://kb.pigment.com/llms.txt > Use this file to discover all available pages before exploring further. # Create and Edit a Board in an Application > [!WARNING] > ⚠️ **Important** > > Members must have the “Can configure” Board permission to be able to create or modify Boards. ## Board options When you create a Board, you can provide a title, subtitle, icon, and color. The color you select determines the appearance of the tile or list item when viewed in the **All Boards** or within a folder. By enabling the options to display an icon next to the title and to use color in the header, you can showcase the chosen color and icon in the header of the board. You can also [add a logo to the Board header](/v1/docs/add-company-logo#add-a-logo-to-a-board-header). Please note that the color palette available for selection is specially curated for Board icons and is not editable. Icons are valuable in aiding the identification of a Board's purpose. These icons will be visible on the Board's tile or list item, whether the Board is inside a folder or in the "All Boards" section. Additionally, they will appear in the sidebar alongside the board's name. You can also add a logo to your Board header for further customization. ### Adjust Board options You can edit the folder, icon, subtitle, and color by accessing the three dots menu next to a Board on the sidebar. The same menu can also be accessed directly from the Board's tile or list item. You can also display a color, icon, or logo on the Board's header. To set a color, icon, or logo for the Board: - Click **Edit** on the Board you wish to modify. - Select the **Format** button. - Use **Set icon** to set an icon for the Board. The icon will appear on the Board header, list, sidebar, and gallery. - Use **Header image** to toggle an **Icon** or **Logo** to **On** for the Board header. Your logo will only appear on the Board header. > [!NOTE] > ℹ️ **Note** > > Go to **Logo, Colors & Images** in **Workspace Settings** to upload or update your logo. ## Create a Board To create a Board, first, open an Application. You will automatically land on the “All Board" section. 1. Click the Button "+ New Board" on the right. 2. Enter a Board name 3. Choose a Color and Icon 4. Add an optional subtitle for more context. 5. Assign a Folder 6. Click Create and configure ### Organize Boards with Folders Boards are organized into Folders. When a Board is added to a folder, it will appear under that folder in the sidebar, you can also click on a folder in the sidebar and it will show you all of your Boards. Boards will be displayed in either tile or list view depending on your selection. When creating a Board, you can also create a new folder by typing the name of the new folder and clicking the option to **+ Create** the new folder. > [!NOTE] > ℹ️ **Note** > > Members must have “Create & Delete Folders” permission to be able to create new folders. ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/d96e56a2-eed1-4778-8679-82d40ab3899c.gif) ## Add widgets Boards are made up of widgets. There are various types of widgets. Grid, KPI, and Chart are all used to display data from Metrics and Tables. Lists allow you to display Transactions or Dimension Lists on a Board. Text is used to create Titles, instructions, and other text to provide context for a Board. ### Grids Grids are made up of [Tables](/v1/docs/tables-summarize-information) or [Metrics](/v1/docs/measure-data-metrics) to allow Members to view their data. They can be used to input data, view calculations or see reporting output after analysis. Within Grids, you can set up the grid in [Sheet View](/v1/docs/how-to-use-sheet-view) which displays a Table or Metric in a familiar spreadsheet format for users to perform side ad-hoc calculations on. ### Charts When working with Charts, Pigment has several different types; [Bar](/v1/docs/bar-chart-options), [Line](/v1/docs/line-chart-options), [Waterfall](/v1/docs/waterfall-charts), [Pie](/v1/docs/get-started-report-charts), and [Combined](/v1/docs/get-started-report-charts). For more information, see [Getting started with Charts](/v1/docs/get-started-report-charts). ### Lists You can publish [Transaction and Dimension lists](/v1/docs/model-lists) to a Board. These can be published as a widget for Members to be able to [add items to a list from a Board](/v1/docs/add-items-to-list-from-board). They can also be used to summarize data or used with [filters](/v1/docs/filter-data-pigment) for a Data validation board. ### KPI KPI or Key Performance Indicators are a great way to highlight important data points. [Pigment KPIs](/v1/docs/display-performance-kpi-widgets) can include a description, conditional formatting and can be set up to include up to 12 data points in one KPI. ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/6d58773e-111c-4c7a-a319-31107122861c.png) ### Text Text widgets can be used to add instructions or context to a Board. After Adding a [text widget](/v1/docs/dimensioned-text-widget), you can drag and drop the edges to determine the size of your text box. The **Enter** key will provide line breaks and you can highlight text to provide different heading sizes, Bold, Italics and Underlined options. You can also highlight text to provide links. ### Images Add images to your Boards with the Image widget. [Image widgets](/v1/docs/image-widgets) can be used to add logos or other images to a Board. ### Action Buttons [Action buttons](/v1/docs/action-widgets) can be configured for navigation to other Boards, Include external links, or trigger an import. ### Spacer The Spacer widget helps organize and structure your Board layout by adding empty space or a visual divider between widgets. It is only available on Boards and does not display or interact with data. How to add a Spacer widget: 1. In your Board, select **Edit Board**. 2. Click **+ Add a Widget** and select **Spacer**. 3. By default, it acts as a blank space. In the widget settings, you can choose to display a horizontal divider by selecting **Display a divider line**. > [!TIP] > 🎓**Resources** > > Check out the course in the Academy on [When to Use the Different Types of Widgets on a Board](https://academy.pigment.com/when-to-use-the-different-types-of-widgets-on-boards). ## Interact with a Board After a Board is complete, you can follow these steps to [grant access to Members](/v1/docs/board-permissions-grant-board-access) to the Board. Depending on the permission you grant them, they can [comment](/v1/docs/add-comments-on-board) and[Interact with widgets](/v1/docs/interact-widgets-board) in these ways. ## Duplicate Boards Duplicating Boards is an efficient way to simplify the creation of new Boards, particularly when two Boards that share similar structures or configurations. While maintaining separate Boards can be more work, but it often helps usability by delivering targeted information to specific audiences. Duplicated Boards are useful for: - Reusing elements like navigation buttons, images, and text widgets with standardized formatting. This is especially useful when these components are consistent across multiple Boards. - Preserving intricate selector setups, such as hidden selectors or those relying on Application Variables. - Adapting Boards to suit distinct needs: - Adjust for regional or language-specific requirements. - Provide specific indicators for different business units, for example, software and hardware teams. To duplicate a Board: 1. Click the three dots menu beside the Board name. 2. Click **Duplicate.** 3. Clean up unnecessary widgets for your new use case. ## Duplicate a Widget You can duplicate a widget either on the same Board or on other Boards within the same Application. ### Duplicate a Widget on the same Board To duplicate a widget within the same Board: 1. Go to the **Board**. 2. Select **Edit**. 3. Open the **three-dot menu** on the widget. 4. Select **Duplicate**. The duplicated widget will appear directly below the original. ### Duplicate a Widget to another Board To duplicate a widget to a different Board in an Application: 1. Go to the **Board**. 2. Select **Edit**. 3. Open the **three-dot menu** on the widget. 4. Select **Duplicate to**, then choose the destination Boards. You can select more than one. 5. Boards that are part of a Sequence will display how many Sequences they belong to. 6. Select **Duplicate**. The duplicated widget will appear at the top of each selected Board. See also: [Measuring what you need with Metrics](/v1/docs/measure-data-metrics) [Playing with views](https://community.gopigment.com/reporting-data-visualization-83/playing-with-views-198) [Create Charts to explore data](/v1/docs/get-started-report-charts) [Commenting on a Board](/v1/docs/add-comments-on-board) [Board Inspiration](https://community.gopigment.com/modeling-guides-71/board-inspiration-including-top-tips-for-board-design-100)