---
title: "Homarr Boards — Dashboard Management"
aliases: [homarr-dashboard, homarr-boards]
tags: [homarr, homelab, self-hosted, dashboard]
sources: [raw/Homarr documentation 2.md]
created: 2026-04-19
updated: 2026-04-19
---

## What Is a Board

A **board** is Homarr's term for a dashboard. You can have multiple boards, each at its own URL slug (e.g. `my-homarr.com/board/smart-home`). Board names must be unique — the name becomes the URL path.

## Creating a Board

- **Name** — no special characters except `_` and `-`; min 1 character; used as URL slug
- **Column count** — defines the horizontal grid for drag-and-drop layout
- **Public** — bypass login requirement; modifications still require explicit group permission

## Board Settings

Accessed via three-dot menu in board list or cog icon on the board page itself.

### General

| Field | Purpose | Fallback |
|-------|---------|---------|
| Page title | Shown top-left in navbar | "Homarr" |
| Meta title | Browser tab title | Board name + suffix |
| Logo image URL | Top-left image | Homarr logo |
| Favicon image URL | Tab favicon | Homarr logo |

### Layout (Responsive Breakpoints)

- Multiple layouts per board — each with its own column count and breakpoint (min screen width)
- When breakpoint of next layout is reached, layout switches automatically
- Adding a new layout auto-generates positions from column count
- New items default to 1×1, placed at first available position
- Name is internal only (not visible on board)

### Background

- **Image URL** — any external or local image URL
- **Attachment** — scrolls with page or stays fixed
- **Size** — `cover` (cropped) vs `contain` (no crop, may not fill)
- **Repeat** — useful for seamless tile patterns

### Appearance

| Setting | Effect |
|---------|--------|
| Primary color | Accent on active elements |
| Secondary color | Secondary accent |
| Opacity | Color opacity |
| Icon color | App/bookmark icon tint |
| Item radius | Corner rounding on tiles/categories |

### Custom CSS

- Per-board CSS — only applied on that board's page
- Does not affect other boards

### Behaviour

- **Disable app status** — turns off the ping/status checks for apps on this board (see [[wiki/homelab/homarr-apps|Homarr Apps]])

### Access Control

Three permission levels:

| Level | View | Edit mode | Settings | Danger zone |
|-------|------|-----------|----------|-------------|
| View board | ✓ | | | |
| Modify board | ✓ | ✓ | ✓ | |
| Full access | ✓ | ✓ | ✓ | ✓ |

- Users/groups not listed on a private board cannot see it at all (no link exposure)
- Admin-level groups show as "inherited" — implicitly permitted
- **Must click Save** after changing permissions or changes are discarded

### Danger Zone

- **Rename** — breaks all existing links permanently, no redirect
- **Visibility** — default private; public exposes to unauthenticated users
- **Delete** — irreversible

## Duplicating a Board

- Copies settings + layout; does **not** copy user/group access or integrations the duplicating user lacks access to
- Available via three-dot menu in board list → "Duplicate board"

## Home Board

The home board loads at the root path (`my-homarr.com` or `my-homarr.com/boards`).

### Scope hierarchy

| Scope | How to set |
|-------|-----------|
| Yourself | Board list three-dot → "Set as home" **or** User profile → Preferences → Home board |
| Other user | Management → Users → Manage → select user → Home board dropdown |
| User group | Management → Users → Groups → Manage → Settings tab → Home board |
| Global (server) | Management → Settings → Boards → Home board (only public boards selectable) |
| Mobile home board | Same as above — set separately; detected via User-Agent header |

- Per-user setting overrides global
- Global applies to users with no personal preference set, and to anonymous users

## Key Takeaways

- Boards are URL-slug-based dashboards; name = URL path, must be unique
- Responsive layouts are per-board with configurable column counts and breakpoints
- Access control is additive — unlisted users on private boards get zero visibility
- Renaming breaks links permanently — plan slugs before going live
- Home board can be set at 5 scopes: self, user, group, global, mobile — each overrides the next
- Custom CSS is scoped per-board
- Duplicate does not clone access permissions or unauthorized integrations

## Related

- [[wiki/homelab/homarr-apps|Homarr Apps — Managing Dashboard Links & Status Checks]]
- [[wiki/homelab/homarr-api|Homarr API — Programmatic Dashboard Management]]
- [[wiki/homelab/home-server-101|Home Server 101 — Beginner's Guide to Self-Hosting]]

## Sources

- `raw/Homarr documentation 2.md` — Homarr v1.59.2 official docs, boards section
