Source: https://docs.pageloop.ai/guides/help-center-design

# Help center design

# Help center design

**Help center design** controls the appearance and identity of your Pageloop-hosted help center. Use it to match your brand, choose readable colors and fonts, and set the links readers see at the top of the site.

> [!NOTE]
>
> Help center design is available to admins with a Pageloop-hosted help center. It does not customize a help center hosted by an external provider.

## Open Help center design

1. Open **Knowledge Base** in the Pageloop sidebar.
2. Select **Help center design** at the bottom of the knowledge base navigation.
3. Choose a section from the design sidebar.

Changes save automatically as draft configuration; saving does not publish the design. Check the save status or error beneath the field before leaving. Use **Back to knowledge base** to return to the knowledge base, where you can preview and publish your changes.

![Help center design showing General settings and the design sidebar](/images/uploads/screenshot-de47a2ad.png)

## General

| Option                 | What it controls                                                                                                                                                                                        |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**               | The help center name shown in the browser tab, navbar, and search results.                                                                                                                              |
| **Description**        | A one-sentence summary of what the help center covers, for search engines and AI assistants.                                                                                                            |
| **Default appearance** | The mode readers land in before choosing a mode themselves. **System** follows the reader’s system preference; **Light** starts in light mode; **Dark** starts in dark mode. The default is **System**. |

**Name** and **Description** supply the help center’s identity and summary rather than changing its visual style. Colors, logos, fonts, appearance mode, and navbar controls customize the reader’s interface rather than setting that summary. For shared-link and search-result imagery, see [Default images](#default-images), including the live-site limitation.

Use **Domains, repository and other settings** to open the knowledge base settings rather than the visual design controls.

### Style guidelines

The **Style guidelines** area describes a document upload for PDF, Word (`.doc` or `.docx`), Markdown (`.md`), or plain text (`.txt`) files. The intended use is for Pageloop to follow those guidelines together with the **Tone** in **Settings → Style** when writing suggestions.

> [!NOTE]
>
> The **Upload** control is disabled and marked **Coming soon**. You cannot upload a style-guideline document from this screen. The described use of uploaded guidelines is not an available workflow.

To review the tone, open the **Account** menu, select **Settings**, and choose **Style** under **Writing**. **Tone** is set during onboarding and is read-only; the field’s hint explains how to request a change.

## Colors

Set separate **Light** and **Dark** values for each color. Choose a color with the swatch or enter a hex value; press Enter or leave the hex field to save it.

| Option              | What it controls                        | If left empty                                            |
| ------------------- | --------------------------------------- | -------------------------------------------------------- |
| **Primary**         | Links, buttons, and active navigation.  | A primary color is required.                             |
| **Accent**          | Highlights alongside the primary color. | Uses the primary color for that mode.                    |
| **Page background** | The background behind text and links.   | Uses `#FFFFFF` in light mode and `#000000` in dark mode. |

A **Low contrast** warning appears when a primary color has less than 4.5:1 contrast against its page background. Review both light and dark cards in **Preview** to check the saved design.

## Branding

| Option             | What it controls                                        | Guidance                                                                                                                 |
| ------------------ | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Logo**           | Your logo for light backgrounds.                        | Upload or drop a logo image.                                                                                             |
| **Dark mode logo** | A logo suited to dark backgrounds.                      | Leave empty to use the light-mode logo.                                                                                  |
| **Favicon**        | The icon in the browser tab.                            | Use a square image, 32 × 32 pixels or larger, that remains legible at 16 pixels. The screen recommends ICO, PNG, or SVG. |
| **Logo link**      | The destination readers open when they select the logo. | Enter the destination URL.                                                                                               |

Branding uploads accept PNG, JPG, GIF, WebP, SVG, or ICO files up to 25 MB.

## Typography

Choose whether to use one font throughout the help center or a separate font for headings.

| Option               | What it controls                                             |
| -------------------- | ------------------------------------------------------------ |
| **Single font**      | Shows one **Font** selector for everything on the site.      |
| **Heading and body** | Shows separate **Heading font** and **Body font** selectors. |
| **Heading font**     | Titles and section headings.                                 |
| **Body font**        | Running text, lists, and tables.                             |

The default font is **Inter**. Choosing the same heading and body font collapses the selection to a single font. Switching to **Single font** removes the separate heading font. The **Ag** sample beside each selector shows the selected font, and **Preview** shows the saved design in light and dark mode.

#### Available fonts

Sans-serif choices: Inter, Roboto, Open Sans, Lato, Montserrat, Poppins, Source Sans 3, Nunito, Nunito Sans, Raleway, Work Sans, Rubik, Noto Sans, IBM Plex Sans, DM Sans, Manrope, Mulish, Karla, Figtree, Plus Jakarta Sans, Outfit, Lexend, Urbanist, Space Grotesk, Sora, Barlow, Fira Sans, PT Sans, Ubuntu, Cabin, Josefin Sans, Quicksand, Heebo, Hind, Archivo, Public Sans, Red Hat Display, Red Hat Text, Libre Franklin, Albert Sans, Onest, and Geist.

Serif choices: Merriweather, Lora, Playfair Display, Source Serif 4, PT Serif, IBM Plex Serif, Roboto Slab, Crimson Pro, and EB Garamond.

## Navbar

The navbar is the bar across the top of the help center.

| Option             | What it controls                                                                                                                                       |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Primary action** | Choose **Button** for a filled button, **Link** for a plain link beside the other links, or **None** to hide the primary action.                       |
| **Label**          | The text readers see on the primary action. Keep it short; the screen recommends two words at most. Appears when the primary action is Button or Link. |
| **URL**            | The primary action’s destination. Appears when the primary action is Button or Link.                                                                   |
| **Links**          | Additional links shown to the left of the primary action, in the order listed. Each link has a label and URL.                                          |
| **Add link**       | Adds another link row. Fill in both its label and URL to save the link.                                                                                |
| **Remove link**    | Removes that row from the navbar configuration.                                                                                                        |

Both a label and URL are needed to save an action or link. If you leave a previously saved entry incomplete while editing, its last complete value stays saved. Other navbar changes can still save; a message identifies the entries you need to finish.

## Default images

Default images are fallbacks for articles that do not have an image of their own.

> [!WARNING]
>
> You can upload and save these choices in `docs.json`, but the live site does not use them. The screen identifies live-site support as a later release.

| Option          | Intended use                                                                      | Suggested dimensions |
| --------------- | --------------------------------------------------------------------------------- | -------------------- |
| **Cover image** | Behind the article title. Keep the center simple so the title remains readable.   | 1600 × 400 pixels    |
| **Card image**  | Link previews when someone shares an article in Slack, Linear, or search results. | 1200 × 630 pixels    |

Both options accept PNG, JPG, GIF, or WebP images. Upload or drop an image into the appropriate area.

## Related pages

- [The Pageloop sidebar](/guides/pageloop-sidebar) — find Knowledge Base and Settings.
- [Writing docs](/guides/writing-docs) — page metadata and navigation in `docs.json`.
