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

# Dashboard elements

> Add titles, text boxes, images, and embedded content to your Hoop dashboard for better organization and branding.

Beyond data widgets, you can add visual elements to your dashboard to improve organization, provide context, and make the layout more intuitive for your team. Elements include titles, text boxes, images, and embeds. These help you rename sections, add team notes, display branding, and integrate external content.

## Adding elements

<Steps>
  <Step title="Enter edit mode">
    Click the **pencil icon** on your dashboard to enter edit mode.
  </Step>

  <Step title="Open the Add Widget panel">
    Click **"Add Widget"** to open the widget and element selection panel.
  </Step>

  <Step title="Switch to the Elements tab">
    Click the **Elements** tab. You'll see options for Titles, Text Boxes, Images, and Embed.

    <Frame caption="The Elements tab in the Add Widget panel">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/6wlH0ZEykyQqefII/images/dashboard-elements-tab.png?fit=max&auto=format&n=6wlH0ZEykyQqefII&q=85&s=0bb3f6644a316f6ae58b151882938fc2" alt="Elements tab in widget panel" width="1620" height="619" data-path="images/dashboard-elements-tab.png" />
    </Frame>
  </Step>

  <Step title="Configure and save">
    Select the element you want to add, configure it to suit your needs, then click **Save**. Click **Save Changes** when your layout is complete.
  </Step>
</Steps>

After adding an element, you can reposition it by dragging it to a new location, or resize it by dragging the corner handle.

## Available element types

<AccordionGroup>
  <Accordion title="Titles">
    Add headings to organize your dashboard into logical sections. Useful for renaming areas, adding important notes for your team, or increasing the branding of your workspace.

    <Frame caption="Dashboard title element with text and color customization">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/6wlH0ZEykyQqefII/images/dashboard-elements-title.png?fit=max&auto=format&n=6wlH0ZEykyQqefII&q=85&s=638dfa96e36b347c179ed58617aba2ce" alt="Title element configuration" width="612" height="865" data-path="images/dashboard-elements-title.png" />
    </Frame>

    **Title options:**

    * **Current Date** — automatically shows today's date
    * **Dashboard Name** — displays the current dashboard's name
    * **Custom Text** — type any text you want

    You can customize the text color, background color, and text alignment.
  </Accordion>

  <Accordion title="Text boxes">
    Add formatted text blocks to your dashboard — useful for motivational quotes, goals, notes for your team, or instructions. Text boxes support standard formatting: alignment, letter color, bulleted lists, numbered lists, and more.

    <Frame caption="Text box element showing a formatted note on the dashboard">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/6wlH0ZEykyQqefII/images/dashboard-elements-textbox.png?fit=max&auto=format&n=6wlH0ZEykyQqefII&q=85&s=b629da82832a495c17e7a1232ec93c8a" alt="Text box element configuration" width="616" height="720" data-path="images/dashboard-elements-textbox.png" />
    </Frame>
  </Accordion>

  <Accordion title="Images">
    Add logos, charts, screenshots, or any image to make your dashboard more dynamic and personalized. Images are sourced from your media library.

    <Frame caption="Image element showing branding or visual content on the dashboard">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/6wlH0ZEykyQqefII/images/dashboard-elements-image.png?fit=max&auto=format&n=6wlH0ZEykyQqefII&q=85&s=516a965f8eb0611620c83ad9dc58c87e" alt="Image element configuration" width="552" height="621" data-path="images/dashboard-elements-image.png" />
    </Frame>

    **Image options:**

    * Add a title (you can hide it in Advanced Settings)
    * Click the image box to open your media library and select or upload an image
    * Choose an **Image Fit** option from the dropdown to control how the image fills the element box
  </Accordion>

  <Accordion title="Embed">
    Embed external content such as web pages, Google Data Studio reports, Google Docs, slideshows, calendars, Loom videos, YouTube videos, social media posts, and more. Embedded content integrates through iframes, turning your dashboard into a real-time business hub.

    <Frame caption="Embed element type selection between URL and IFRAME">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/6wlH0ZEykyQqefII/images/dashboard-elements-embed.png?fit=max&auto=format&n=6wlH0ZEykyQqefII&q=85&s=1ba9b6a1df20658e77ee8b64ee548289" alt="Embed type selection" width="1612" height="692" data-path="images/dashboard-elements-embed.png" />
    </Frame>

    **Embed types:**

    | Type       | When to use                                              |
    | ---------- | -------------------------------------------------------- |
    | **URL**    | Enter a valid URL directly to embed the page             |
    | **IFRAME** | Paste iframe embed code provided by the external service |

    **Advanced Settings:** Hide the widget title for a cleaner look by enabling **Hide Title**.

    **Embedding YouTube videos:**

    1. Copy the video ID from the YouTube URL (the part after `/watch?v=`)
    2. Insert it into: `https://www.youtube.com/embed/<video-id>`
    3. Use the resulting URL in your embed element

    **Embedding TikTok videos:**

    1. Copy the video ID from the TikTok URL (the part after `/video/`)
    2. Insert it into: `https://www.tiktok.com/embed/<video-id>`

    **Embedding Instagram posts:**

    1. Get the shareable link for your Instagram post
    2. Replace `?utm_source=ig_web_copy_link` with `/embed/`

    <Note>
      Some websites restrict iframe embedding due to security policies. Always check the source site's embedding guidelines if your content does not display correctly.
    </Note>
  </Accordion>
</AccordionGroup>

## Tips for using elements effectively

<Tip>
  Use **Title elements** to create clear visual sections that separate different data areas — for example, a "Sales Performance" header above opportunity widgets and a "Team Activity" header above task and call widgets.
</Tip>

<Tip>
  Use the **Text Box element** to pin a weekly team goal or motivational message that everyone sees when they log in.
</Tip>

<Tip>
  If you manage multiple dashboards, remember that element configurations are specific to each dashboard. Custom themes and layouts are maintained when you clone a dashboard.
</Tip>
