# Customising a dashboard

A campaign's dashboard is the default page members of a campaign see. When a campaign is nearly created, it's fairly empty. To start adding **widgets** to the dashboard, scroll down and click on the **dashboard setup** button.

## Dashboard setup

This page allows you to add more widgets to a dashboard by scrolling to the bottom of the page and clicking on the **add new widget** block. Existing widgets can be moved around by drag-and-drop (this doesn't work on mobile devices).

There is no limit for the number of widgets on a dashboard, but the more info, the longer the page load, the less clarity the dashboard has, and the worse the experience for you and other users due.


## Types of widgets

There are several type of widgets that can be added.

### Entry List

This shows a list of entries on the dashboard. This can be set up to show only entries of a specific type, and in which order they are displayed. Filters allow more control on exactly what is shown.

### Entry Preview

This *pins* an entry to the dashboard, showing its image and a preview of the entry's entry.

### Calendar

This widget displays one of your campaign's calendar on the dashboard, including 5 previous and upcoming events.

![Calendar dashboard widget](img/dashboard-calendar.png)

#### Known Limitations

The more reoccurring reminders in a calendar, the less the previous/next list is accurate, by virtue of the code not being able to process thousands of reminders on each page load, each with custom reoccurring values and varying permissions.

Reminders reoccurring on moon phases are also completely ignored from the calendar widget, as those are impossible to calculate without regenerating the whole calendar.

### Text Header

This add a full row of just text on the dashboard, useful for splitting sections up. For example having a "The heroes" text above 4 entry previews of the campaign's players.

### Random Entry

Similar to the entry preview, this however selects a random entry from the campaign to display on the dashboard.

### Campaign Header

Always visible on the default dashboard of a campaign, this widget can be added to other dashboards and shows the campaign's name, short description, and dashboard image as a background.

![Campaign dashboard widget](img/dashboard-campaign.png)

### Widget Filters

You can filter entries displayed on the recently modified and random widget by providing a list of fields of the entry and values. For example, you can use `is_dead=1&type=NPC` to filter on dead characters of the NPC type.

To make your life easier, when viewing a filtered list of entries, the filters will have a **copy to clipboard** button. For example, when viewing the characters of the campaign, filter on the kind of characters you want to display, click the button, and past the result in the widget's **filter** field.

![Copy filters to the clipboard](img/dashboard-filters.png)



## Custom Dashboards

[Premium campaigns](https://kanka.io/premium) can have more than a single dashboard.

Non-default dashboards have their own simple permission engine linked to the campaign's roles. For example, a dashboard can be the default one for your players, with a focus on their current quest progress.

## Change default dashboard

You can change the default dashboard by clicking on the **Action** button and choosing **Default** in the **Player** menu.

![Edit default dashboard](img/db_action_btn.png)

![Change visibility](img/db_default_menu.png)

** Revert to default dashboard**

To revert to the normal default dashboard, simply choose the **Visible** choice in front of the relevant role (**Player** in this example).

![Revert to normal default](img/db_visible_menu.png)