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

# Configuring highlights

> Feature important resources and links on your public website homepage

Highlights allow you to showcase important resources, links, and information directly on your public website homepage. Use them to direct residents to frequently accessed content, featured services, or key community resources.

## What are highlights

Highlights appear as a row of clickable cards on your public website homepage, beneath the search bar. Each highlight displays:

* **Icon** - A visual indicator for the type of content
* **Title** - A short, descriptive label
* **Link** - Where residents go when they click the highlight

Highlights help residents quickly access important information without searching, reducing the steps needed to find common resources.

## When to use highlights

Highlights work well for:

* **Frequently requested resources** - Elevation Certificates, flood zone maps, or permit applications
* **External links** - Community websites, FEMA resources, or insurance information
* **Featured pages** - Public table views, map layers, or submission forms
* **Seasonal content** - Hurricane preparedness, grant programs, or enrollment periods

<Tip>
  Choose highlights that address your most common resident inquiries. Review your Get Help logs to identify what residents ask about most frequently.
</Tip>

## Adding highlights

<Steps>
  <Step title="Open public website settings">
    Navigate to **Settings** > **Account** > **Public Website**.
  </Step>

  <Step title="Find the highlights section">
    Scroll to the **Highlights** section.
  </Step>

  <Step title="Add a highlight">
    Click **Add highlight** to create a new highlight card.
  </Step>

  <Step title="Configure the highlight">
    Fill in the highlight details:

    * **Title** - Enter a short, descriptive label (1-3 words work best)
    * **URL** - Enter the destination link (internal or external)
    * **Icon** - Select an icon that represents the content
  </Step>

  <Step title="Save your changes">
    Click **Update** to publish the highlights to your public website.
  </Step>
</Steps>

<Check>
  Your highlights are now visible on your public website homepage. Visit your public website to verify they appear correctly.
</Check>

## Managing highlights

### Reordering highlights

Drag and drop highlights to change their display order. The first highlight appears on the left, and additional highlights follow in sequence.

### Editing highlights

To modify an existing highlight:

1. Navigate to **Settings** > **Account** > **Public Website**
2. Find the highlight you want to edit
3. Update the title, URL, or icon
4. Click **Update** to save changes

### Removing highlights

To remove a highlight:

1. Navigate to **Settings** > **Account** > **Public Website**
2. Click the delete icon next to the highlight you want to remove
3. Click **Update** to save changes

## Best practices

### Content selection

* **Prioritize high-value resources** - Feature content that saves residents time or answers common questions
* **Limit the number of highlights** - 3-5 highlights maintain visual clarity without overwhelming residents
* **Balance internal and external links** - Mix Forerunner pages with relevant external resources

### Title guidelines

* Keep titles short (1-3 words)
* Use action-oriented language when appropriate ("Get Help", "Find Zone")
* Match terminology residents expect ("Flood Maps" vs. "FIRM Panels")

### Icon selection

Choose icons that:

* Clearly represent the content type
* Are distinct from each other for easy scanning
* Match the visual style of your public website

## Common highlight examples

| Highlight                  | Suggested icon | Link destination                                  |
| -------------------------- | -------------- | ------------------------------------------------- |
| **Flood Maps**             | map            | Public map view or external FEMA map service      |
| **Get Help**               | message-circle | Get Help form or contact page                     |
| **Permits**                | file-text      | Permit submission form or permit information page |
| **Elevation Certificates** | file-check     | EC search or public file view                     |
| **Insurance Info**         | shield         | External flood insurance resources                |
| **Hurricane Prep**         | cloud-rain     | Seasonal preparedness resources                   |

## How residents see highlights

When you configure highlights:

* They appear in a horizontal row on the homepage
* Residents can click any highlight to navigate to the linked content
* External links open in a new browser tab
* Internal links navigate within your public website

### Mobile display

On mobile devices, highlights:

* Display in a scrollable horizontal row
* Maintain touch-friendly tap targets
* Show the same icons and titles as desktop

<Tip>
  Test your highlights on both desktop and mobile to ensure they display well and links work correctly on all devices.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Highlights not appearing on public website">
    **Check that:**

    * You have at least one highlight configured
    * You clicked **Update** to save changes
    * The highlight has a title, URL, and icon set

    Try refreshing your public website or viewing in an incognito window.
  </Accordion>

  <Accordion title="Highlight link not working">
    **Common causes:**

    * URL is missing the protocol (should start with `https://` for external links)
    * Internal page path is incorrect
    * Linked page no longer exists

    Verify the URL by copying it directly into your browser's address bar.
  </Accordion>

  <Accordion title="Can't add more highlights">
    There may be a limit on the number of highlights you can add. Contact your Customer Success Manager if you need to display more highlights or want to discuss alternative approaches.
  </Accordion>

  <Accordion title="Highlights appear in wrong order">
    Drag and drop highlights in the settings panel to reorder them. The order in the settings matches the display order on your public website. Click **Update** after reordering to save the new arrangement.
  </Accordion>
</AccordionGroup>