Control cells

Designed to give more power to your audience

Introduction

The Count canvas is built for more than just static reports. Adding controls to your canvas transforms them into interactive reports and documents.

What are interactive controls?

Interactive controls are special cells that enable readers to interact with a shared canvas. Each control produces a table of one or more values that your readers can edit, that can be referenced just like any other cell.

You can create the following types of interactive controls:

How to add an interactive control

Use the canvas toolbar to insert control cells:

How to connect to your queries

There are a few things to know about control cells in order to connect them to your queries:

Control cells are tables

Control cells have one column value that contains the current value of the control cell.

You can inject them just about anywhere in your SQL

As control cells are just tables, you can add them into your WHERE statements to filter values, into the logic of a new column, or any other way you can think of!

You can either refer to control cells using pure SQL, or using jinja templates.

Redshift users should take note of this limitation and workaround when referencing control cells using SQL.

You can customize the placement, look and feel of them

When you think about how you want others to interact with control cells, you can customize:

  • the title (or prompt) the user sees

  • where the control cell is located

  • the options available

  • the default values selected

How to enable for other users

Control cells will behave differently depending on whether a user has edit or view access to a canvas, and whether the canvas is locked or unlocked.

The table below summarizes how these two states interact:

šŸ” / AccessCanvas EditorCanvas Viewer

Unlocked canvas

āœ… Can edit control cells šŸ‘ Edits are visible to everyone

āŒ Cannot edit control cells šŸ‘ Can see edits to control cells made by editors

Locked canvas

āœ… Can edit control cells šŸ™ˆ Can only see their own edits

āœ… Can edit control cells šŸ™ˆ Can only see their own edits

In summary, if you want a canvas to act like a typical dashboard or notebook where many users are using filters independently then make sure you lock the canvas, but if you intend to use the canvas as a collaborative space, then keep the canvas unlocked and invite contributors to be editors.

Last updated