> For the complete documentation index, see [llms.txt](https://guides.noloco.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.noloco.io/nola/canvas/configuring-canvases.md).

# Configuring a Canvas

Set a Canvas's route, spaces, and visibility rules just like any other page

A Canvas is a real page in your app, so it's configured the same way as every other page. You use the right-hand sidebar to set where it lives in your app, who it's for, and when it appears — while you continue to edit the page's content by chatting with [Nola](https://guides.noloco.io/nola.md).

This keeps the experience consistent: **Nola handles the page body, the sidebar handles the page settings.**

<figure><img src="https://319575345-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifpIQWu0HCVYAt51oT%2Fuploads%2Fgit-blob-96ff2c03b3d7284236c2d4fd345971d287858fe7%2FNola-Configuring-Canvas-Pages.png?alt=media" alt=""><figcaption></figcaption></figure>

## Route

The **route** is the page's address within your app. Set a clear, readable route so the Canvas has a sensible URL and is easy to link to.

See [renaming pages](https://guides.noloco.io/pages/renaming-pages.md) for how routes and page names work together.

## Assigned spaces

If your app uses [spaces](https://guides.noloco.io/settings/spaces.md), you can assign a Canvas to one or more spaces to control which part of your app it belongs to. The page appears in the navigation for the spaces you assign it to, exactly like a standard page.

## Visibility rules

Use [visibility rules](https://guides.noloco.io/pages/page-visibility-rules.md) to decide who can see the Canvas and when. You can:

* Show the page only to specific [user roles](https://guides.noloco.io/users-and-permissions/user-roles-and-permissions.md)
* Show or hide it based on the logged-in user or their data
* Combine conditions to fine-tune access

Because a Canvas uses the same visibility system as the rest of your app, the permissions you already understand apply here without any special handling.

{% hint style="info" %}
Visibility rules control who can **see** the page. The data inside a Canvas still respects your [record-level](https://guides.noloco.io/users-and-permissions/user-roles-and-permissions/record-level-permissions.md) and [field-level permissions](https://guides.noloco.io/users-and-permissions/user-roles-and-permissions/field-level-permissions.md), so users only ever see the records they're allowed to.
{% endhint %}

## Publishing

A Canvas publishes with the rest of your app. When you [publish](https://guides.noloco.io/settings/publishing.md), the current version of each Canvas goes live alongside your other changes, so what your users see always matches what you last published.

## Next steps

{% content-ref url="/pages/XO0diqL1H6pd9QAcnv4n" %}
[Troubleshooting a Canvas](https://guides.noloco.io/nola/canvas/troubleshooting-canvases.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://guides.noloco.io/nola/canvas/configuring-canvases.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
