> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deandesk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pages

> Build public and internal pages with the block editor or raw HTML — including embedded YouTube playlists and custom CSS.

<Info>
  **School-level feature** — managed within your school portal at `yourschool.deandesk.com`.
</Info>

The **Pages** module lets you build content pages for your school — public landing pages, program pages, internal staff pages, course material pages, and more. Pages support a visual **block editor** for non-technical authors and a raw **HTML editor** for power users.

## Open the page editor

Go to **Admin Dashboard → Pages**. The list shows every page in your school with its title, slug, status (draft / published), and last-edited date. Click **New Page** to start a new page, or click any page to edit it.

## Page editor modes

Each page can be edited in one of two modes:

| Mode       | When to use it                                                                                                        |
| ---------- | --------------------------------------------------------------------------------------------------------------------- |
| **Blocks** | Visual editor with text, image, video, embed, and layout blocks. Best for non-technical authors and most pages.       |
| **HTML**   | Raw HTML with optional custom CSS. Use when you need full control over markup or want to paste a hand-crafted design. |

You can switch between modes from the editor toolbar. DeanDesk shows a **confirmation dialog** before switching, since switching from blocks to HTML serializes the blocks (and switching back may lose formatting that doesn't map cleanly to a block).

## Block editor

The block editor lets you build a page by stacking blocks. Each block is a self-contained unit (text paragraph, image, button, video, etc.) that you can reorder and edit independently.

### Available blocks

| Block                | What it does                                                             |
| -------------------- | ------------------------------------------------------------------------ |
| **Text**             | Rich-text paragraph with formatting                                      |
| **Heading**          | H1–H6 headings                                                           |
| **Image**            | Single image with alt text and optional caption                          |
| **Video**            | Embed a video by URL                                                     |
| **YouTube playlist** | Embed an entire YouTube playlist with a built-in player and chapter list |
| **Button**           | Call-to-action button linking to a URL                                   |
| **Card group**       | Grid of cards with title, description, and optional icon                 |
| **Divider**          | Horizontal rule                                                          |
| **Spacer**           | Vertical whitespace                                                      |

### Adding a YouTube playlist

<Steps>
  <Step title="Insert the block">
    In the block editor, add a **YouTube Playlist** block.
  </Step>

  <Step title="Paste the playlist URL">
    Paste a YouTube playlist URL (e.g. `https://youtube.com/playlist?list=PL...`). DeanDesk fetches the playlist's videos and shows a preview.
  </Step>

  <Step title="Save">
    Save the page. Visitors see an embedded player with the full playlist queued up.
  </Step>
</Steps>

<Tip>
  YouTube playlist embeds are also available as course **materials** — see [Courses](/setup/courses) for adding them inside a course.
</Tip>

## Custom typography

Each page can override fonts on a per-page basis. From the editor, open the **Typography** panel to:

* Upload font files (WOFF2, WOFF, TTF, or OTF — 10 MB max each)
* Pick a **heading font** and a **body font** from any fonts available to the page (uploaded on this page or in the school-wide page theme)

Per-page typography overrides the school-wide [page theme](/setup/branding#custom-page-theme). Pages with no typography settings inherit the school-wide theme.

<Tip>
  Upload commonly-used brand fonts once in the school-wide page theme so every new page picks them up by default. Save per-page fonts for one-off pages like campaigns or microsites.
</Tip>

## HTML editor

When you switch to HTML mode, the editor shows two panels:

* **HTML** — your page markup
* **Custom CSS** — CSS scoped to this page only (it does not leak into the rest of the portal)

Custom CSS is automatically scoped via a wrapper so your selectors only apply to the rendered page — you don't need to namespace your selectors yourself.

<Warning>
  HTML pages bypass DeanDesk's accessibility helpers. Test your custom HTML with screen readers and keyboard navigation if accessibility matters for your audience.
</Warning>

## Visibility & publishing

Each page has a **status** and a **viewability** setting.

| Status        | Meaning                                            |
| ------------- | -------------------------------------------------- |
| **Draft**     | Saved but not visible to anyone outside the editor |
| **Published** | Live at the page's slug                            |

| Viewability  | Who can see it                        |
| ------------ | ------------------------------------- |
| **Public**   | Anyone, including signed-out visitors |
| **Members**  | Anyone signed in to the school        |
| **Students** | Users with the Student role           |
| **Teachers** | Users with the Teacher role           |
| **Admins**   | Users with the Admin role             |

Use viewability to publish internal-only pages (staff handbooks, admin runbooks) without exposing them to the public.

## Page slugs and URLs

Each page has a slug (e.g. `welcome`, `apply`, `staff-handbook`). Pages are served at:

```
https://yourschool.deandesk.com/p/<slug>
```

Public pages can be linked from your school's home page, your marketing site, or anywhere else.

## Setting the home page

The Page Manager's home page settings control what visitors see at your school's root URL (`https://yourschool.deandesk.com`). Alongside the other home page options, you can set a **Product Page** as your public home page: choose the Product Page option, then pick the product with the product picker.

<Tip>
  A Product Page home page works well when a single program or offering drives most of your signups — visitors land directly on the page where they can enroll.
</Tip>

## Edit, duplicate, archive

From the page list:

* **Edit** — open the page in the editor
* **Duplicate** — create a copy as a new draft
* **Archive** — remove a page from the live site without deleting it

## Building pages with Admin AI

You can ask the [Admin AI](/setup/admin-ai) to build pages for you (*"build a public welcome page with three sections..."*). The assistant renders an Inline Page Builder Card showing the proposed blocks; you can edit, reorder, and publish from the chat.
