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

# Keyplans

> Upload floor plans and site plans, then pin photos and tasks to the spot on site where they belong.

The **Keyplans** tab holds your project's floor plans and site plans. Pins on a plan show where photos were taken and where tasks are.

## Upload a plan

Plans are PDF files. Each file can be up to 50 MB. You choose which pages of the PDF to upload, and each page becomes its own plan.

> [tab] Phone
>
> **1. Open the project's details**
>
> Tap the project's name at the top of the screen. Scroll down to the key plans list.
>
> **2. Pick your PDFs**
>
> Tap **Add new plan** and choose one or more PDF files.
>
> **3. Choose pages**
>
> Under **Select pages**, tick the pages you want, then tap **Continue**.
>
> **4. Name your sheets**
>
> Give each sheet a name. Hold the grip and drag to change the order. Tap **Upload**.
>
> The **Keyplans** tab appears in the project once it has at least one plan.

> [tab] Computer
>
> **1. Start the upload**
>
> Open the project's **Keyplans** tab and click **Upload**. If the project has no plans yet, click **Upload keyplans**.
>
> **2. Choose pages**
>
> Pick one or more PDF files. Under **Select pages**, choose the pages you want, then click **Continue**.
>
> **3. Name your sheets**
>
> Drag the sheets into order and name each one. Click **Upload**.

> [!NOTE]
>
> Each plan needs its own name. OnSite marks any name that's already used in the project. Change it before you upload.

## Manage plans

This is phone only. In the project's details, the key plans list shows every plan.

* **Preview a plan:** tap it. Tap **View full screen** to open it in the **Keyplans** tab.
* **Change the order:** tap **Edit order**, drag the plans, then tap **Done**.
* **Rename, replace or delete:** tap **…** next to a plan, then choose **Rename**, **Replace** or **Delete key plan**.

When you replace a plan, use a new PDF with the same dimensions as the old one. If the size is different, pins may not appear in the right place.

> [!WARNING]
>
> Deleting a plan also removes all its pins. You can't undo this.

## View a plan

> [tab] Phone
>
> Open the **Keyplans** tab. The plan's name shows at the top. Tap the arrow next to it to switch plans. You can search by name with **Search plans**.
>
> Pinch to zoom and drag to move around the plan.

> [tab] Computer
>
> Open the **Keyplans** tab. Pick a plan from the **Plans** list. The header shows how many pins the plan has. Use the zoom buttons or **Reset** to change the view.
>
> Filter the pins with the menus above the plan:
>
> * **All**, **Photos** or **Tasks**
> * **Creation Date**, **Creator** and **Chat group**
> * For tasks: **Assignee**, status (**All**, **Open** or **Completed**), **Category** and **Due Date**
>
> Drag the **Creation Date** slider below the plan to show pins from a shorter period. Click **Hide pins** to see the plan on its own. Click **Clear** to remove your filters.

## Open a pin

There are two kinds of pin: photo pins and task pins.

> [tab] Phone
>
> Tap a pin. A photo pin opens **Photo details**, with who took the photo and when. Tap the photo to see it full screen. A task pin opens **Task details**.

> [tab] Computer
>
> Hover over a pin to see who created it. Click a photo pin to open the photo. Click a task pin to open the task.

## Pin a photo to a plan

You can pin photos, but not videos.

> [tab] Phone
>
> **When you send a photo.** Take or choose a photo in a chat. If the project has plans, they show at the top under **Pin Image to Plan**. Tap a plan, tap the spot on the plan, then confirm. A small plan appears on the photo. Tap it to open **Manage Pin**, where you can **Edit pin location on plan** or **Delete the pin**. Then send the photo.
>
> **A photo that's already shared.** Open the photo full screen and tap **Pin to Plan**. Choose a plan, tap the spot, then confirm. You can pin a photo you sent. Project admins can pin anyone's photo.

> [tab] Computer
>
> In a chat, click **+** in the message box, then **Upload photos or videos**. Choose a photo and click **Pin Image to Plan**. Choose a keyplan, click the location, then click **Use Pin**. To start again, click **Remove Pin**. Then send the photo.
>
> In a chat, a pinned photo shows a pin badge. Click it to open the photo on its plan.

## Give a task a location

A task's location is a pin on one of the project's plans.

> [tab] Phone
>
> Open the task and tap **Location**. Choose a plan, tap the spot, then tap **Save**.
>
> If you create a task from a pinned photo, the task gets the photo's location. See [Tasks](https://docs.on-site.io/work/tasks.md).

> [tab] Computer
>
> Open the task and click **Pin to keyplan**, or **Edit keyplan location** if it already has one. In **Choose Task Location**, select a keyplan, click on the plan to place the pin, then click **Save location**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.