# How to use Frames

{% embed url="<https://www.youtube.com/watch?v=GEPv-aYlk3I>" %}

## Frame on the Canvas Toolbar:

<figure><img src="https://2113117739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoXL90G447T7Arsje35d9%2Fuploads%2FlLIo4GO3za1Ni4UyZyAf%2FNew%20Toolbar%207.31%20-%20Frame.png?alt=media&#x26;token=c5f6f6de-b465-458c-b549-9db889aca9c3" alt=""><figcaption><p>Frame icon on the toolbar</p></figcaption></figure>

1. From your [<mark style="color:purple;">**Canvas**</mark>](https://www.canoa.supply/canvas) dashboard, either select one of your Canvas boards.
2. At the top is your toolbar is where you can access main functions quickly.
3. The **Frame** icon will turn white when activated.

## Why use Frames?

A Frame allows you to group objects together and gives you the option to export your work out of Canoa. Rather than having to select individual images, placing a Frame around them allows you to easily select, move, and export these elements as a group. Frames are also compared to as being like "presentation slides" within Canvas because of their organizational value.

## Creating a Frame:

1. Click on the **Frame** icon or type **F** and the icon will turn purple when activated.
2. Create a Frame around the items that you'd like to export or print.
3. When the **Frame** feature is active, you will continue creating frames. Hit **ESC** to exit from creating frames.
4. You can **set the ratio** of your Frame to match the shape of common presentation or paper sizes and use that as a guide to layout or organize your Frame.
5. You can select either **Landscape** or **Portrait** orientation.

<figure><img src="https://2113117739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoXL90G447T7Arsje35d9%2Fuploads%2F5LLD8wlNPyhNwV43IO2R%2FScreenshot%202024-02-22%20at%207.46.12%20PM.png?alt=media&#x26;token=8c2b547e-18f3-4494-a6a6-a79e6a694436" alt=""><figcaption><p>Set ratio options and select either landscape or portrait</p></figcaption></figure>

## Naming your Frame:

Every time a Frame is created on the Canvas, it will be automatically numbered according to the order it was created in. For example, Frame 0, Frame 1, Frame 2, etc..

You can always rename your Frames. Naming your Frame is helpful when organizing your Canvas or exporting your Frame. Since a Frame is currently exported one at a time, having a unique name for each Frame helps you identify the Frames as you export them.&#x20;

1. Click on your selected Frame, and then double-click on the **Frame textbox** at the top left of your frame box.
2. Input a new name or title for your Frame. Here are some helpful naming tips:
   * If you're planning on combining your exported Frames into a book or presentation, then you may find it helpful to name your Frame "Presentation Name Page 1"; "Presentation Name Page 2", etc.
   * If you're planning on adding the visuals, floor plans, or schedules into a presentation template that you have, then you may find it helpful to name your Frame by the image or item name such as "Collage" or "Floor Plan" or "Furniture Schedule" etc.

<figure><img src="https://2113117739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoXL90G447T7Arsje35d9%2Fuploads%2FmzEXi32PtR4LkewkiVO9%2FScreenshot%202024-02-22%20at%207.22.56%20PM.png?alt=media&#x26;token=38265558-7edf-4047-a0a2-96d2aedc1d73" alt=""><figcaption><p>Use your Frame textbox to name your frame</p></figcaption></figure>

## Styling your Frame:

By default, all Frames have a white background to start. You then can select a **background color** and set the **opacity** level of that fill color by clicking the **Set Fill Style** icon at the bottom of the Frame when it is selected.

<figure><img src="https://2113117739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoXL90G447T7Arsje35d9%2Fuploads%2FK6XvdPla9yVStwtdQvbt%2FScreenshot%202024-05-15%20at%201.47.52%E2%80%AFPM.png?alt=media&#x26;token=332122ec-15e7-4cbb-b099-4ff4f29ad7d7" alt=""><figcaption><p>Set Fill Style icon is located at the bottom of the Frame when the Frame is activated.</p></figcaption></figure>

You can also select a **border style** by clicking **Set Stroke Style** icon at the bottom of the Frame when it is selected. Choose between a Solid Line, Dashed Line, or Dotted Line and toggle its level of thickness.&#x20;

<figure><img src="https://2113117739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoXL90G447T7Arsje35d9%2Fuploads%2FzbmbYQ38kY4lSTux8iXf%2FScreenshot%202024-05-15%20at%201.47.00%E2%80%AFPM.png?alt=media&#x26;token=ae556f5d-c540-4948-a7e1-a4066d17cb72" alt=""><figcaption><p>Set Stroke Style = chose a border for your Frame</p></figcaption></figure>

## Copying & Deleting a Frame:

To **delete** your frame, simply select the Frame (name or border) and hit the `delete` key on your keyboard. Deleting the Frame will delete the content within the Frame. The elements inside your Frame are linked to the Frame itself.&#x20;

This means when you **copy** a Frame, all of its contents will be copied as well.

If you want to delete only the Frame and *not* the elements inside of it, select the Frame, right-click and select **Ungroup**. The Frame will disappear and the contents will remain on your Canvas.

<figure><img src="https://2113117739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoXL90G447T7Arsje35d9%2Fuploads%2Fk8eusiNPLQi5Y5s3IfIQ%2FScreenshot%202024-03-17%20at%2011.38.51%20AM.png?alt=media&#x26;token=80cbe5df-1462-4388-99dc-06c3a49db4ce" alt=""><figcaption><p>To delete, select your frame and hit delete or select Ungroup</p></figcaption></figure>

Using Frames is similar to using the [<mark style="color:purple;">**Group and Ungroup action**</mark>](https://help.canoa.supply/docs/how-to-create-collages-and-vignettes-for-your-presentations#grouping-images) in Canvas, but Frames holds the power to export your work to PDF, JPEG, PNG, DWG, and DXF - a big function that Grouping does not carry.&#x20;

See below for more details on organizing your Canvas using Frames.

{% content-ref url="how-to-organize-your-canvas-with-frames" %}
[how-to-organize-your-canvas-with-frames](https://help.canoa.supply/docs/design/how-to-organize-your-canvas-with-frames)
{% endcontent-ref %}

See below for more details on exporting or printing your Canvas using Frames.

{% content-ref url="../share/how-to-export-or-print-your-canvas/how-to-export-or-print-your-canvas-with-frames" %}
[how-to-export-or-print-your-canvas-with-frames](https://help.canoa.supply/docs/share/how-to-export-or-print-your-canvas/how-to-export-or-print-your-canvas-with-frames)
{% endcontent-ref %}


---

# Agent Instructions: 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:

```
GET https://help.canoa.supply/docs/design/how-to-use-frames.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
