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

# Run Queries

> How to run queries on the FGA Dashboard

To see how a relationship is established between a user and an object, run a tuple query.

1. Go to the **Tuple Management** page or choose the Query Tool panel in the right part of the screen.

   ![Image showings the query window](https://mintlify.s3.us-west-1.amazonaws.com/auth0-fga/images/fga/docs/content/dashboard/assets/dashboard-query-tool-1a.png)

2. There is a textbox below the header *Query Tool* where you can type the query.

   ![Image showing location of query tool text box](https://mintlify.s3.us-west-1.amazonaws.com/auth0-fga/images/fga/docs/content/dashboard/assets/dashboard-query-tool-2.png)

3. The query is in the form "is x related to y as z?". This form of query will provide visualization on why the relationship exists between user and object.
   The query field supports queries in the form of:

   * *"Is x related to y as z?"*
   * *"Who is related to y as z?"*

### Is x related to y as z?

The first type of query is of the form: "Is x related to y as z?". This form of query will provide visualization on why the relationship exists between user and object.

1. In the query box, type "Is adam related to team:awesome as member?" and type *Enter*.

   ![Image showing query box question](https://mintlify.s3.us-west-1.amazonaws.com/auth0-fga/images/fga/docs/content/dashboard/assets/dashboard-query-tool-3.png)

2. Successful queries will show visualization on how the relationship is established in the **Query Tool** panel. In addition, there is a green *YES* box in the panel.

   ![Image showing successful query](https://mintlify.s3.us-west-1.amazonaws.com/auth0-fga/images/fga/docs/content/dashboard/assets/dashboard-query-tool-success.png)

3. Unsuccessful queries will be denoted with a red *NO* box in the **Query Tool** panel.

   ![Image showing unsuccessful query](https://mintlify.s3.us-west-1.amazonaws.com/auth0-fga/images/fga/docs/content/dashboard/assets/dashboard-query-tool-fail.png)

### Who is related to y as z?

The second type of query is of the form: "Who is related to y as z?". This form of query will provide visualization on who has a particular relationship with an object.

1. In the query box, type "Who is related to team:awesome as member?" and type *Enter*.

   ![Image showing query box with question who](https://mintlify.s3.us-west-1.amazonaws.com/auth0-fga/images/fga/docs/content/dashboard/assets/dashboard-query-who-1.png)

2. A successful query will show visualization on all the users that have the relationship in the **TUPLE QUERIES** panel. As it can be seen, only adam and ben has member relationship with team:awesome.

   ![Image showing query box with question who with answer](https://mintlify.s3.us-west-1.amazonaws.com/auth0-fga/images/fga/docs/content/dashboard/assets/dashboard-query-who-2.png)