Dashboards let you put multiple queries on one page so you can see your key metrics at a glance. The queries on a dashboard can be table results, or charts. This feature is only available for Premium Team users.
Look for the Dashboards tab in the top left of your screen and click
New Dashboard. Your teammates will appreciate if you give your dashboard a name and description. 😊
When looking at a query, click
Add to Dashboard. A modal will appear with a list of dashboards. You can also create a new dashboard from here.
When looking at a dashboard, look for the
Search for a query... input and type the name of your query.
When looking at a dashboard, click on the dropdown menu on a query, and click
If any of the queries on your dashboard have variables, you'll see a list of variables and their values underneath the dashboard name. These values will be shared among every query that uses that respective variable.
If you want a specific query to use its own value for a variable, click
If your query is chartable, click the dropdown near the top right of your widget, and hit
View as chart.
You can add a text widget to the dashboard by clicking the
Add Text button. These are great for explaining your analysis or creating sections within your dashboard. Text widgets use markdown formatting.
Most HTML won't work in text widgets for security purposes, but you can add a line break using
To add an image to a dashboard first insert a text widget, then click on the image icon in the text menu. The markdown format for an image will pop up and all you need to do is insert the URL for your image where url is shown in parenthesis. You can add descriptive text in between the brackets, though it isn't necessary. Once the URL and text are ready to go, just click out of the text field and you will see your image in your dashboard.
Note: images can only come from public URLs. If you have an image in a file on your computer, upload it to your web browser so you can get a compatible link for the PopSQL dashboard.
When you first create a dashboard, it starts off private. When you're ready to share the dashboard with your team, click the
Share button in the top right to make it viewable/editable by your team, or make it public to anyone with the link.
Using the presentation link, people can refresh the dashboard right from their browser, and they can change query variables like date ranges or customer IDs. Note that this requires a cloud connection.
On our enterprise plan, you can create granular permissions and specify exactly which people/teams can view or edit your dashboard.
To refresh a dashboard, click the
Refresh button near the top right:
You can also refresh individual queries by clicking the dropdown on a query, and clicking
You can schedule a dashboard to auto refresh by clicking the
Schedule Refresh button near the top right. Optionally, you can configure PopSQL to send a Slack message or an email whenever the dashboard refreshes. Note you must have a cloud connection to use this feature.
All good things must come to an end. When you're ready to delete your dashboard, use the left sidebar, right click on your dashboard, and hit
Updated about 1 month ago