> For the complete documentation index, see [llms.txt](https://interfacing.gitbook.io/interfacing-help-files/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://interfacing.gitbook.io/interfacing-help-files/administration-and-configuration/managing-and-customizing-the-home-page/editing-the-home-page.md).

# Editing the Home Page

Customize your Home Page layout using drag-and-drop tools.

The **Home Page Editor** provides a flexible, drag-and-drop interface for customizing the layout and content of your Home Page. Currently, only administrators have access to the **Editor**. 

***

## Interactive Tour

See how to build a tailored Home Page by selecting widgets, customizing their settings, and making the layout available to users.

{% @howdygo/embed url="<https://app.howdygo.com/share/f2065529-2312-4bf7-9f99-4564d997f543>" fullWidth="true" %}

***

## Accessing the Home Page Editor

To begin customizing your Home Page:

1. Navigate to your Home Page.
2. Click **Edit Home Page** in the top-right corner.

This opens the **Home Page Editor** interface.

***

## Using the Home Page Editor

The **Home Page Editor** is organized into three main sections that work together to help you build, position, and configure widgets on your Home Page:

### <i class="fa-grid-2">:grid-2:</i>  Widget Panel (Left)

This panel contains all available widgets, grouped into expandable categories for easy navigation.&#x20;

* **Custom Widgets**: Add and configure content widgets to display key information.
* **Smart Widgets**: Add interactive widgets that display personalized, real-time information.

### <i class="fa-pen-ruler">:pen-ruler:</i>  Layout Canvas (Center)

This area represents the editable layout of the Home Page. Use it to:

* Position widgets using drag-and-drop
* Rearrange existing widgets
* Remove unwanted widgets

### <i class="fa-gear-complex">:gear-complex:</i>  Settings Panel (Right)

This panel displays configuration options for the selected widget.

***

## Working with Widgets

Use these steps to add, move, edit, and delete widgets within your Home Page layout.

{% stepper %}
{% step %}

### Adding Widgets

* From the **Widget Panel**, drag a widget into the **Layout Canvas**.
* Drop zones will appear to guide placement.
* Release the widget in the desired location.

***

{% endstep %}

{% step %}

### Moving Widgets

* Hover over the widget.
* Find the **six-dot drag** (<i class="fa-grip-dots-vertical">:grip-dots-vertical:</i>) handle in the top-right corner.
* When the cursor changes to a **hand** (<i class="fa-hand-pointer">:hand-pointer:</i>) icon, click and drag the widget to a new location.

***

{% endstep %}

{% step %}

### Editing Widgets

* Click the widget in the canvas.
* The **Settings Panel** updates to display configuration options for the selected widget.
* Adjust settings as needed.

{% hint style="warning" %}
Only one widget can be edited at a time. Selecting a different widget updates the panel accordingly.
{% endhint %}

***

{% endstep %}

{% step %}

### Deleting Widgets

* Hover over the widget.
* Click the **X** icon in the top-right corner to remove it from the layout.

***

{% endstep %}
{% endstepper %}

***

## Saving & Publishing Changes

Use the controls in the top bar to manage your layout:

* **Revert Changes**: Discard all unsaved modifications
* **Save Changes**: Save your draft without publishing
* **Publish**: Make the layout live for all users (respects user-level customization settings, if enabled)
* **Close Editor**: Exit the editor interface

{% hint style="success" %}
For a full walkthrough, see [**Saving & Publishing the Home Page**](/interfacing-help-files/administration-and-configuration/managing-and-customizing-the-home-page/saving-and-publishing-the-home-page.md).
{% endhint %}

***

## Need Support?

Refer to the following guides for detailed instructions:

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>How to Use Custom Widgets</strong></td><td>Add and configure content widgets to display key information.</td><td data-object-fit="cover"><a href="https://1488562728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTx7AmE0d2Q4ja20EYjF5%2Fuploads%2FsFYOWYEmV76Zcw7MUIEV%2FIMS-V16-NAV-Home-Icons-3.png?alt=media&amp;token=7fa83b87-fe16-4699-b669-b05743e41523">IMS-V16-NAV-Home-Icons-3.png</a></td><td><a href="/interfacing-help-files/administration-and-configuration/managing-and-customizing-the-home-page/editing-the-home-page/using-custom-widgets.md">Using Custom Widgets</a></td></tr><tr><td><strong>How to Use Smart Widgets</strong></td><td>Add interactive widgets that display personalized, real-time information.</td><td data-object-fit="cover"><a href="https://1488562728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTx7AmE0d2Q4ja20EYjF5%2Fuploads%2FkCXX6jRk7lKofI4Zs2cP%2FIMS-V16-NAV-Home-Icons-4.png?alt=media&amp;token=b6e796f9-73cd-42e8-86dc-78db7ca12f74">IMS-V16-NAV-Home-Icons-4.png</a></td><td><a href="/interfacing-help-files/administration-and-configuration/managing-and-customizing-the-home-page/editing-the-home-page/using-smart-widgets.md">Using Smart Widgets</a></td></tr><tr><td><strong>How to Define Widget-Level Permissions for Users</strong></td><td>Set permissions that control how end users can interact with and personalize widgets on their Home Page.</td><td><a href="https://1488562728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTx7AmE0d2Q4ja20EYjF5%2Fuploads%2F4dFHq1mxhn6Cbggvt0nq%2FIMS-V16-NAV-Library-Icons-65.png?alt=media&amp;token=5984f763-ccbd-495c-a49c-60209f3b5b79">IMS-V16-NAV-Library-Icons-65.png</a></td><td></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://interfacing.gitbook.io/interfacing-help-files/administration-and-configuration/managing-and-customizing-the-home-page/editing-the-home-page.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.