# Banner (/docs/configuration/banner)

Display important messages to all your users at the top of the app. Perfect for announcements, maintenance notices, or updates.

<Callout type="info" title="Quick Overview">
  - Only **one banner** can be active at a time
  - Schedule banners to appear and disappear automatically
  - Choose whether users can dismiss the banner or not
  - Show banners to everyone, or only logged-in users
</Callout>

---

## Creating a Banner

Run this command to create or update a banner:

```bash
npm run update-banner
```

You'll be guided through a few simple prompts:

```ansi
--------------------------
Update the banner!
--------------------------
Display From (Format: yyyy-mm-ddTHH:MM:SSZ, Default: now):
> 2025-12-02T09:00:00Z

Display To (Format: yyyy-mm-ddTHH:MM:SSZ, Default: not specified):
> 2025-12-31T23:59:59Z

Enter your message (Enter a single dot "." on a new line to finish):
> 🎉 Welcome to LibreChat! Check out our new features.
> .

Is public (y/N):
> n

Is persistable (cannot be dismissed) (y/N):
> n
```

<Callout type="tip" title="What do these options mean?">
  - **Display From/To**: When the banner should appear and disappear. Leave empty for "now" and "forever"
  - **Is public**: Show to visitors who aren't logged in (like on the login page)
  - **Is persistable**: If yes, users can't dismiss the banner — use for important notices
</Callout>

---

## Deleting a Banner

```bash
npm run delete-banner
```

You'll see the current banner and be asked to confirm before deleting.

---

## Example Banners

<Tabs items={['Welcome Message', 'Maintenance Notice', 'Security Alert']}>
  <Tabs.Tab>
    A simple welcome message that users can dismiss:

    ```bash
    npm run update-banner "" "" "👋 Welcome to LibreChat!" "false" "false"
    ```
  </Tabs.Tab>
  <Tabs.Tab>
    A scheduled maintenance notice that can't be dismissed:

    ```bash
    npm run update-banner "2025-12-20T00:00:00Z" "2025-12-21T06:00:00Z" "⚠️ Scheduled maintenance on Dec 20th, 2-6 AM UTC" "true" "true"
    ```
  </Tabs.Tab>
  <Tabs.Tab>
    An urgent security notice visible to everyone:

    ```bash
    npm run update-banner "" "" "🔒 Please update your password by January 1st" "true" "true"
    ```
  </Tabs.Tab>
</Tabs>

---

## Date Format

Use this format for dates: `yyyy-mm-ddTHH:MM:SSZ`

**Examples:**
- `2025-12-25T09:00:00Z` → December 25, 2025 at 9:00 AM (UTC)
- `2025-01-01T00:00:00Z` → January 1, 2025 at midnight (UTC)

Leave the date empty to use the current time or no end date.