How to save and share queries

You can save queries to re-run them later, schedule them, or share them.

Save a query

To save a query:

1. Open the query in Insights.
2. At the top right of the query, click the Save button.
3. In the resulting Save query dialog, enter the following details:
   1. For Query name, enter a name for the query.
   2. (Optional) For Description, add a description for the query.
   3. For Collection, you can either:
      • If you have access to existing collections, click the Choose collection dropdown to select an existing collection.
      • If you do not have any existing collections, click the Create Collection button. In the Create collection dialog, enter the following details:
        1. For Name, enter a name for the collection.
        2. (Optional) To the left of the name, click the image icon to choose an icon for the collection.
        3. (Optional) For Description, describe the collection.
        4. (Optional) For Share, select other users or groups that can access the collection. (See below for more details.)
        5. At the bottom of the Create Collection dialog, click Create.
   4. (Optional) For Certificate, click the No certification dropdown to assign a certificate to the query.
   5. (Optional) For Linked terms, click the Select terms dropdown to assign a term to the query.
   6. At the bottom of the dialog:
      • To only save your query, click Save.
      • To save and share your query, click Save and share.
        1. In the Query saved dialog, enter the following details:
           1. For Add users or groups, select other users or groups that can access the saved query.
              1. (Optional) To the right of the user or group, click the Editor dropdown to change the sharing permissions:
                 • Viewer allows users to view and run all queries in the collection, but not edit them.
                 • Editor allows users to view, run, and edit all queries in the collection.
              2. Click Invite to invite the users or groups.
           2. (Optional) Click Copy Link to copy the link for the saved query to share with others in your team.
           3. (Optional) Click the Slack or Teams button to share directly on Slack or Microsoft Teams, respectively.
        2. Click Done to confirm your selections.

Share a query collection

To share a collection of queries:

1. Open Insights.
2. In the upper left, click the papers-in-a-box icon.
3. Under the icon, click the name of the selected query collection.
4. From the resulting list of collections, hover over the collection you want to share.
5. Click the 3-dot icon to the right of the collection name and choose Edit collection.
6. In the Edit collection dialog, under Share:
   1. Search for users or groups with whom to share the collection.
   2. (Optional) To the right of the user or group, click the Can edit dropdown to change the sharing permissions:
      • Can edit allows users to view, run, and edit all queries in the collection.
      • Can view allows users to view and run all queries in the collection, but not edit them.
   3. Repeat these steps for each user or group with whom you want to share the collection.
7. At the bottom of the Edit collection dialog, click Update.

Move a saved query

To move a saved query to another query collection:

1. Open Insights.
2. In the upper left, click the papers-in-a-box icon.
3. Under the icon, click the name of the selected query collection.
4. From the resulting list of collections, hover over the collection from which you want to move a query.
5. Click the 3-dot icon to the right of the saved query name, and then click Move to.
6. In the Move to dialog, select the query collection to which you want to move your saved query.
7. Click Move to complete moving the saved query.

To duplicate, rename, edit, or delete your saved query, click the 3-dot icon to the right of the saved query name and select the relevant option.

View query sidebar

Once you've saved a query, you can access the query sidebar to view additional context for your saved queries.

To open the query sidebar for a saved query:

1. In the left Explorer panel in Insights, hover over a saved query and click the Open query sidebar icon.
2. From the query sidebar in the right, you can:
   • View details about your saved query in Overview, including the actual query.
     
     • (Optional) To provide more context for your queries, in Overview, click +Add README to add a README to your saved query.
   • Click the Relations tab to view the queried assets.
   • Click the Activity tab to view the activity log for the saved query.
   • Click the Schedules tab to view associated schedules for the saved query, if any.
   • Click the Resources tab to view any linked resources.
   • Click the Requests tab to view any requests on the saved query.
   • Click the Properties tab to view query properties.
   • Click the Slack or Teams tab to view Slack or Teams messages pertaining to the query.