Guides

Read a dashboard

You opened a dashboard in arkush: your own, or one that someone sent you. With this guide, you learn what you see there and what you can do with it.

A dashboard published to the internet opens at its own address, with no account. For what that page shows, read Publish it to the internet.

The header holds, from left to right:

• arkush, the name of the app. Select it to open the dashboard library, the list of the dashboards you can open. On an org install, the server's own name or logo can show before arkush.
• The dashboard title.
• The freshness chip: a clock and the age of the oldest saved data on the dashboard, such as "2 d ago". To learn more, read How old is the data.
• The View | Edit switch.
• Share and Subscribe.
• The Inbox button: a bell icon with no text. A number on the bell counts the entries you have not read.
• The account button: a person icon. It opens your account menu, with the email you signed in with, Settings, Help and Sign out. When you are not signed in, a Sign in button shows instead. The light and dark mode and Plain background are buttons at the foot of the icon rail at the right edge of the page.

The View | Edit switch shows only when you can edit the dashboard. Without edit access, "(view only)" follows the title, for example "Acquisition weekly (view only)". Share and Subscribe still show. On an org install, the switch reads View | Sandbox for a viewer, and View | Edit | Sandbox for an editor, when the editors allow sandboxes. A sandbox holds charts of your own over the dashboard, which only you and its editors see. Read Add a chart of your own in a sandbox.

The data is a saved copy

Every chart reads a snapshot: saved rows, from a query, a sheet, or an imported file. Opening a dashboard runs no query and costs nothing, on your account or on anyone else's.

When an editor, an agent or the scheduled refresh changes the dashboard while you read it, the dashboard shows the change in place. A notice names who changed what, for example "The scheduled refresh updated the data." The changed blocks light up for a moment. To see them again, select Show changes in the notice. A published copy on the internet does not change while you read it.

How old is the data

The header shows the freshness chip: a clock and the age of the oldest saved data, such as "1 d ago". Select the chip to see each datasource, the named set of saved rows that charts read. The list opens under the chip, and the dashboard stays in place. Each row shows a glyph for the kind of datasource, its name, and a clock with the age of its data. A datasource with no saved data shows a dash.

Point at a row to read the state of the datasource. On a dashboard with a schedule, each datasource that the schedule refreshes is On time, Behind its schedule, Scheduled refresh stopped, or Scheduled refresh stopped retrying, which means that its runs failed six times in a row. A stopped refresh also shows a pause glyph, and the reason shows when you point at it. Press Escape or click outside the list to close it.

To see more, such as row counts and columns, select Open the Data workspace at the foot of the list. An editor also gets Refresh data there.

Some dashboards refresh on a schedule. The Data workspace then also shows the schedule and its next run. If a scheduled run was due and the data did not refresh, the chip turns amber: the data is older than the schedule allows. In the list under the chip, the age of the datasource that is behind turns amber. Point at its row to read the state and what to do. An editor switches to Edit and refreshes the data. Anyone else asks an editor of the dashboard to refresh it. On a dashboard without a schedule, the chip shows the age only and never turns amber. There, the data changes only when an editor refreshes a datasource or replaces its data.

How much to trust it

Some dashboards carry a small colored mark beside the title: a pencil for Draft, a blue check for Ready, a green filled check for Official, an amber circled × for Retired. The mark is a claim a named person made about the dashboard. Point at the mark to see the level, who vouched, and when.

A dimmed mark means that the dashboard changed after the stamp, and you see that in its tooltip. The numbers can still be correct, but the claim is older than the content.

Filters change only your view

Controls are the drop-down lists, date pickers, and typing boxes on the canvas. They change what you see in your browser. They never change the dashboard, and they never run a query. For every test a control can apply, such as "contains" or "is between", the chart clicks that filter, and where each filter reaches, read Filter a dashboard.

On a big dashboard, the funnel icon in the icon rail at the right edge opens the Controls panel. It lists every filter and parameter of the dashboard in one place, with the same controls as the canvas. The number on the icon is the count of filters that are set.

A long list opens with a filter box. Type a few letters to find any value, even one the list does not show at first. When some rows have no value, the list ends with an (Blank) row, in italics, which finds those rows. In a multi-select list the row checks beside the other values, so one selection keeps a value and the blank rows together. A single-select list offers (Not blank) beside it. When the value you need is not listed, type it and select the Use "…" row.

Some list controls carry an Exclude switch beside their label. With Exclude on, the control hides the selected values instead of keeping them. With (Blank) selected, it then keeps only the rows that do have a value. Clear empties the selection. Like any selection, the switch goes into the page address and does not change the dashboard.

A text or number control shows its test on the label row — "contains", "starts with", "is greater than", "is between", "is blank", and more. Select the test to change it. "is between" filters only after you fill both bounds. An excluding test, such as "does not contain" or "is not", also matches the rows with a blank value, and you read this in a line under the control. Clear returns the test to the author's choice.

While a control is open, hovered, or focused, the canvas outlines the blocks its filter reaches. An amber outline marks a block whose data lacks the filtered column — the filter does not apply there.

Your selections become part of the page address. To share your exact filtered view, select Share in the header, then Copy link. A reload keeps the selections too.

On some blocks, the author lets a click filter the other blocks. Select a bar, a point, a legend entry, or a table cell to filter by its value. The other marks of that chart fade. Select the same value again, or the empty space of the chart, to clear the filter. Filter a dashboard describes how to add values, drag across dates or numbers, and filter with the keyboard.

Try a scenario with a slider or a field list

Some controls change what a chart computes or shows instead of which rows it reads. A slider sets a number, such as a growth rate, and the charts and numbers that use it move while you drag. A field list switches what a chart shows, such as the breakdown by region or by channel, or the metric on its axis. These controls filter no rows.

1. Drag the slider, or type an exact value in the box beside it and press Enter. A value outside the slider's range is set to the nearest end.
2. Open the field list and select a field. The chart, its axis title, and its title follow.
3. To go back to the author's values, click Reset all in the Controls panel.

Like a filter, your choice goes into the page address and never changes the dashboard, so a link you copy opens on the same scenario.

Read the values under the pointer

Point at a chart, and you see the values of the mark under the pointer in a box. On a chart whose author turned on the rich tooltip, the box has more:

• On a line over dates, the box has every line at the date nearest the pointer, largest first, with each line's change since the date before and a total. A vertical line marks the date.
• On a bar, the box also has the bar's rank, its distance from the average, and its share of the total.
• On a stacked or a grouped bar, the box has the name of the part under the pointer, such as its region, and a comparison with the other parts of the same bar or group.

To act on the values in the box:

1. Stop the pointer over the chart for half a second. The box then has its buttons.
2. Move the pointer into the box. Select Keep only to filter the dashboard to that value, Exclude to filter it out, or Copy values to copy the shown values.

On a chart that a click does not filter, you pin the box with a click, and release it with a second click. On a touch screen, you pin it with a tap. Escape, Close, or a press outside the box closes it. When Keep only is missing, the chart filters nothing. When Copy values is missing, your organization limits who may take data away: ask an admin.

Read a table

Unless the author turned sorting off, click a column header to sort by that column. Click the header again to reverse the order. A table longer than one page shows a pager under its rows. The sort and the page change only your view, and the app does not save them into the dashboard.

A wide table scrolls sideways, and the author can hold the first columns in place while the others scroll. Scroll over a table to move through its content. When the content ends, the canvas pans instead. A footer row summarizes all the rows behind the table, on every page.

Some columns show their values as links or pictures. Select a link to open it. A link column does not filter.

A pivot table groups rows into levels. Select the control in the row header of a group to open or close that group. The pager of a pivot table counts row groups instead of rows.

A column can show a trend line in each row in place of a number: the value over time for that row alone. The author can also put a chart in the rows' tooltip. Point at a row, and a chart filtered to that row shows beside it. With the keyboard, move to the row and press Enter. On a touch screen, tap the row. The chart then opens in a dialog. Press Escape or select Close to close it.

Find a word on the dashboard

With Search, you find what the browser's own find misses: the words inside a chart, the rows on a table's other pages, and the charts out of view.

1. Press ⌘ F on a Mac, or Ctrl F elsewhere. You can also select Search in the rail at the right. The Search panel opens with the cursor in its field.
2. Type a word. Capital letters and accents do not matter, and part of a word is enough. The panel lists the matches block by block, and says where each one sits: a title, text, a chart value, or a table row and its page.
3. Select a match, or press Enter for the next one and Shift Enter for the one before. The canvas moves to the block and opens its page, and a table turns to the page with the row.

While the panel is open, each block with a match has a ring and a count. In a chart, each matching mark has an outline, and the selected match shows its values beside it. In a table, each matching cell has an outline. Close the panel, and the marks go away.

You search only the rows that the filters leave. If a word you expect has no match, clear the filters in Controls and search again. To use the browser's own find, press ⌘ F or Ctrl F a second time while the cursor is in the search field.

Find a dashboard or a datasource

You can find any dashboard or datasource you can open by the words inside it, from any page: a title, a note, a chart's axis, a column name or a warehouse table. A datasource is the table of rows behind a dashboard's charts. The search never reads the rows themselves, so a value such as a city name finds nothing.

1. Press ⌘ K on a Mac, or Ctrl K elsewhere. You can also select the magnifier in the bar at the top of the page. Before you type, the list shows the dashboards you opened last. The list is empty until you open one.
2. Type a word of three letters or more. Capital letters and accents do not matter, and part of a word is enough: "plica" finds "applicants". Every word you type must match. Each row names the dashboard or the datasource, and under it the line that holds your word, such as "On the dashboard: How applicants move" or "Column: customer_orders". Your words are marked in the row. A dashboard with your words in its title comes first.
3. When two dashboards have the same title, look at the end of the row. It shows the official mark when an analyst stamped the dashboard Official, the owner's initials when you are not the owner, and how long ago the last edit was. Point at the initials to see the owner's address.
4. Select a row, or move with the down and up arrows and press Enter. A dashboard opens with the Search panel at the right showing your word, so you land on the block that holds it. A datasource opens in its dashboard's Data workspace, where its columns are listed. A datasource from the library opens its own page.

With fewer than three letters, the list keeps the dashboards you opened last and says to type more. When nothing matches, the list says so: try another word, a part of a word, or a column name. A dashboard nobody shared with you is not in the list. If you know it exists, ask its owner to share it with you.

The list shows at most 20 dashboards and 20 datasources. When more match, the group says so, such as "20 of 63". Select Show all 63 on the Dashboards page to see every match there, with your words already in its search field. You can also type more words to make the list shorter.

On a dashboard, the list ends with Find on this dashboard, which runs the same word in the Search panel. To open a result in a new tab and keep this page, press ⌘ Enter or Ctrl Enter on it. Press Escape, or ⌘ K again, to close the list. The search fields on the Dashboards page and in the datasource library find the same words.

Run a command from the keyboard

The same list runs the app's commands: Refresh data, Schedule a delivery, Share this dashboard, Add a chart, a panel such as Show comments, a zoom, dark mode, and the rest of what the header and the canvas offer. A command shows its key at the end of its row, so the list is also the app's list of keys.

1. Press ⌘ K or Ctrl K, and type the start of a word in the command's name: "ref" finds Refresh data. Up to three commands that match sit at the top of the list, above the dashboards and datasources.
2. Press Enter to run the command at the top, or move to another with the arrows.

To see every command, press ? anywhere outside a text field, or type > first in the list. The list then shows commands alone, under a Commands chip in the field. Before you type, the list also offers Dashboards… and Datasources…: press Tab on one to search that kind alone. Press Backspace in the empty field to search everything again.

You see only the commands you can take: a viewer finds no Add a chart. A command this server has turned off shows greyed, with the reason under it, such as Schedule a delivery on a server with no channel to post to. A command that needs a form opens it: Schedule a delivery opens Scheduled sends on a new delivery.

Chart options

In view mode, a chart's header carries the Chart options button. It offers the comparison with an earlier period: turn the comparison on or off, or pick another period. On a chart with dates on an axis, Show dates by switches the chart between day, week, month, quarter and year. The chart redraws for you alone. The dashboard, and what everyone else sees, do not change. A scorecard carries Scorecard options, and a table that sums values by rows carries Table options, with the same comparison.

The popover shows your adjustment beside the dashboard's own setting, with Reset. An adjusted chart keeps the button visible, with the name "Chart options — adjusted". A CSV downloaded from the block then holds the adjusted rows.

The adjustment goes into the page address with your filter selections. When you share the address, the reader sees the chart as you adjusted it. A reload keeps the adjustment. Opening another dashboard drops it.

Where the author turned it on, a Dates picker at the bottom right of the canvas, beside the zoom control, switches the dates of every chart it reaches at once: by day, week, month, quarter or year. Select Each chart's own to put each chart back on the dates that its author set. Your pick goes into the page address too. On a chart you changed with Show dates by, your pick stays until you select Reset in its Chart options.

Read an article

An article is a finding its author wrote up beside the dashboard. Open Articles on the right icon rail, or select Read the article on an article card on the canvas. The icon shows only when the dashboard has an article.

Each chart in an article shows the filters its author set, whatever you set on the canvas. To explore from that point, select Open in dashboard under the chart: the canvas opens with those filters, and you change them from there. Select ‹ Canvas to go back without them.

When the data changed after the article was written, a notice at the top says so. The charts show the current data, and the text may describe the data as it was.

Read a dashboard page by page

Some dashboards are split into pages. On those, you see a Canvas | Pages switch over the top of the canvas, and you start on the first page. A link to a page, or to a block on a page, opens on that page. If the author set the dashboard to open on the canvas, you start on the whole canvas, except on a phone.

1. If you see the whole canvas, select Pages. The page fits the width of the window, and is never larger than its real size.
2. Select a page tab, or press → and ← to go to the next and the previous page. The tabs sit beside the switch, in page order, and each tab has the name of its page. On a phone, the tabs have a line of their own under the switch. Home and End go to the first and the last page.
3. To show the pages fullscreen, select Present at the end of the tabs. The open page fills the screen. Press → or Space for the next page and ← for the previous page. Press Escape to go back to the page view.
4. To see the whole dashboard again, select Canvas.

Your filters stay the same on every page. A long page does not fit the window: scroll down to read the rest.

To send a link to one page:

1. Open the page.
2. Select Share in the header, then Copy link. You can also copy the address from the browser. The link opens the same page, with your filters.

The link gives no access. A person you send it to needs access to the dashboard.

To send a link to one block, add ?block= and the block's id to the address of the dashboard. The link opens the page that holds the block, with the block in view. When no page holds the block, the link opens the canvas, centered on the block. The block pulses once. An agent gives you this link for each block it draws.

Fill the screen with one chart

Point at a chart, a sankey, a table, or a note, and a fullscreen button appears in its header. Select the button, and the block fills the screen. To come back, press Escape, or select the same button in the corner. The fullscreen header shows the data of the block again: a size meter for its rows and a clock with the age of the data, so a screenshot always shows how old the data is. Point at the meter for the row count, and at the clock for the exact refresh time.

At full width, a chart drawn for a small block has small text and thin lines. Use the sliders under the chart to make the text and the lines larger. Text size scales the text. The weight slider takes its name from the mark the chart draws: Line weight on a line, Bar thickness on bars, Point size on points. More holds the other controls: Fewer axis labels, Gridlines, and Show every point on a line or an area. You see a control only when it applies to the chart.

Select the label of a slider to reset that slider. After you adjust anything, a Reset button appears. The app does not save these adjustments or put them in the page address. Each time you open fullscreen, the chart starts fresh.

A table fills the screen with as many rows as fit, and has no sliders. A pivot table fills the screen as a crosstab, the shape it has on the canvas. A note reads as a page: a centered text column that scrolls. To get a high-resolution image of a chart, download it while it is fullscreen. The picture then has the fullscreen size.

Select Rows in the fullscreen header to read the rows behind the block. The grid shows the data the chart or the table draws from, with the dashboard's filters applied — the same rows that Data as CSV writes. Select Rows again to come back to the block. A note holds no data, so it carries no Rows button.

To go straight to the rows, select Show data in the header of a chart or a sankey. With the keyboard, move focus onto the chart or the sankey and press T. Fullscreen opens on the rows, and Escape brings you back to the point of the chart you left.

Take a chart with you

Point at a block and a download button appears in its header. A chart offers three files: Chart as PNG, Chart as SVG, and Data as CSV. Other data blocks offer the CSV alone. On a published dashboard, the menu of a chart also has Copy image link: a link to the chart's picture that you paste into a message (see Put a chart in a message, a README or a slide).

The picture is the chart as you see it, with its theme, filters and current size, at twice the screen resolution. Choose the SVG to print or to resize: it stays sharp at any size. The CSV holds the rows behind the block, with your filters applied and without display formatting. The sort and the page of a table do not go into the CSV. A text value that starts like a formula, with = for example, gets an apostrophe in front, so a spreadsheet reads it as text and does not run it. The file takes the name of the block.

Leave a comment

Anyone who can open the dashboard can comment on it. Point at a block and a comment button appears in its header. Select the comment button to open the Comments panel at that block's thread. The Comments icon in the right rail opens the same panel and carries the count of unresolved comments.

Write in the box at the panel's foot. The comment lands on the selected block, or on the dashboard when no block is selected. Press ⌘/Ctrl+Enter to send it. Your comment carries your signed-in email as its author.

To reply, type in the Reply… field at the end of a thread. You can delete your own comments: Delete sits on the line of each comment you wrote. The app asks first, and a deletion has no undo. Only the editors of the dashboard resolve threads: a resolved thread means that someone acted on the feedback. Under Resolved, each resolved thread folds to one line, and Show opens it.

Once a block has unresolved comments, its comment button shows their count and stays visible without hover.

Add a chart of your own in a sandbox

Org installs only

When a dashboard lacks a chart you need and you cannot edit it, build the chart in your sandbox. A sandbox holds your own charts over the live dashboard. You need view access to the dashboard, and its editors must allow sandboxes.

1. In the header, select Sandbox in the View | Sandbox switch. A banner across the top says that you are in your sandbox.
2. Point at a chart and select ⋯ in its header, then select Copy to sandbox. The copy appears a little below and to the right of the chart, and is selected.
3. Change the copy as an editor changes a chart: drag it, resize it, and open the blocks around it to change its fields and marks. The copy already reads the dashboard's data, so it needs no datasource of its own. For each control, read Build on the canvas.
4. Select Back to dashboard in the banner when you finish.

To start from nothing instead, add a block from the header in step 2. A chart that needs data the dashboard does not show reads it through a derived view: a datasource you add in the Data workspace, written in SQL over the dashboard's datasources.

Your sandbox saves itself. You and the dashboard's editors see it, and nobody else does. The dashboard does not change: its own charts stay locked while the sandbox is open.

To get your chart onto the dashboard, ask its editors. In View, leave a comment on the dashboard that names the chart. Editors see your sandbox in their Sandboxes panel. Your chart stays in your sandbox until an editor adds it. When an editor adds it, a notice names the chart the next time you open the dashboard.

When a save fails, the notice says what to change — for example, a datasource name that the dashboard already uses. When there is no Sandbox in the header, you can edit the dashboard and add the chart to it directly, or its editors turned sandboxes off. In that case, leave a comment that asks the editors for the chart, or for sandboxes.

Read with the keyboard or a screen reader

With the Tab key or a screen reader, you reach the blocks in reading order, top to bottom, and each block title is a heading. A block off screen moves into view when it gets focus. Every chart and every sankey on a dashboard is one stop for the Tab key. Its marks form a grid that the arrow keys walk and that a screen reader reads in browse mode too. On a chart of more than 1,000 marks, browse mode reads the first 1,000, and the arrow keys still reach every mark.

A mark reads as the chart shows it: the field names of the axes, and the numbers and the dates in the chart's own formats. A sankey flow reads as its target and its amount, such as "to Signup, 1,204", and the first flow of a node also names the node and its total. While a mark has focus, a box beside it shows the same values, as the pointer's tooltip does.

A screen reader reads a chart's title, then the author's text description, then a short summary that arkush writes from the chart's data, such as the largest value or the trend. The summary says when your filters narrowed the data. Last, it reads how many series and points the chart has, or how many source nodes and flows the sankey has, and the keys to use, such as "6 series, 96 points. Arrow keys move between marks, and T opens the data as a table." When a key cannot move further, the screen reader says where you are, such as "End of row" or "Last series".

To read the data itself, open the rows: Show data in the block's header, or T on the chart. The rows open as a table that the arrow keys walk. Select a column header to sort, and type in the search field to filter the rows. To keep the rows, download them with Data as CSV (see Take a chart with you).

On a dashboard you can view but not edit, ⌘/Ctrl+A selects the text of the page. arkush follows your system's settings for reduced motion, for more contrast, and for light or dark mode (see See the dashboard in another look).

Report a barrier

If a part of arkush does not work with your keyboard or your screen reader, write to the contact at the foot of the Help panel in the app. On a published dashboard, select Report this page at the foot of the page. Name the page, the block, and what you expected to hear or reach.

Pan and zoom the canvas

The dashboard opens fitted to its width. From there the canvas is free: drag empty canvas or scroll to pan. On a touch screen, drag anywhere — a finger on a chart pans too. Hold ⌘/Ctrl and scroll, or pinch, to zoom. The app does not save your position, so the dashboard opens the same way for everyone.

See the dashboard in another look

The author chose the colors of the dashboard. You can see it in another look, in your browser only. The dashboard does not change, and nobody else sees your choice.

1. At the bottom of the canvas, select the palette icon beside the zoom control.
2. Select a look. The charts and the canvas redraw in the colors of that look, and a dot on the palette icon shows that another look is on.
3. To go back, select As designed.

The menu lists these looks:

• As designed: the theme the author chose, with its name.
• Match my light/dark mode: the dashboard in your light or dark mode. The menu shows it only when the author's theme has one mode.
• The built-in themes of the app, such as Arkush and Paper.
• … (saved): a theme saved to the theme library of the server. The saved themes show only when you are signed in.

The choice lasts while the dashboard stays open. After a reload, and each time you open a dashboard, it shows as designed again. For when the menu offers Match my light/dark mode, read Theme a dashboard → View the dashboard in another look.

Read the charts without the filter labels

When a filter applies to a chart, the header of the chart has a label with the count of filters. The header can also have the chart options and the comment count. With Clean view on, these labels and buttons stay hidden until you point at the chart. You need view mode. The choice is saved in your browser for every dashboard, and nobody else sees it.

1. At the bottom of the canvas, select the eye icon with a line through it, beside the palette icon.
2. Read the dashboard. The chart headers have the title only, and a dot on the icon means that Clean view is on.
3. To see the filters of one chart, point at the chart, or move to it with the Tab key.
4. To show the labels again, select the icon again.

The filters still apply while their labels are hidden. A link that someone shares with you can carry filters, so check the filters of a chart before you quote its numbers.

Get it by email or in Slack on a schedule

Org installs only

A subscription is the charts, scorecards and tables of a dashboard, sent to you on a cadence you choose. Only you receive it. The people who run the install pick where subscriptions arrive: your email inbox, your Slack direct messages, or a channel of its own. The subscription form names it. Only an org install sends subscriptions. When you are signed in, the header shows Subscribe on every dashboard you can open. On arkush.app, Scheduled sends says that subscriptions are available in Arkush for organizations, and links to its page. Open the dashboard in the app when you want its latest data.

1. In the header, select Subscribe. Scheduled sends opens on your subscription.
2. The schedule reads as one sentence, such as "Every weekday at 09:00, Europe/Kyiv time." Select the cadence in it and pick Daily, Weekdays, Mondays or Monthly. For a different schedule, choose Custom and type a cron.
3. Select the time in the sentence to set the time of day.
4. Keep the time zone, or select it in the sentence, type part of a city or region name and pick a zone from the list.
5. Under What to send, select the charts, scorecards and tables you want. To select every chart of a frame, select the checkbox of the frame. To see a chart before you select it, point to its row. Your own sandbox charts are in the group Your sandbox, and only you receive them.
6. Under Filters, read the filters that each send draws with. The form starts from the filters on your screen. To change them, set the filters on the canvas and select Use the filters on screen, or select Use the default filters. A dashboard without filters has no such section.
7. Select Subscribe.

When the editors of the dashboard turn sandboxes off, your sandbox charts leave the send, and the message has the reason. They come back when the editors turn sandboxes on again.

Each message carries the dashboard title, the age of the data, the text, the charts as images, the scorecards, an Open dashboard button and a footer. In Slack, the tables arrive in the thread of the message. In an email, they sit between the charts. A table carries its first 25 rows, and no CSV file comes with it: open the dashboard for the rest of the rows. Send now sends one message at once. Unsubscribe stops the schedule. The Notifications section of your Settings page lists every dashboard you subscribed to.

Scheduled sends opens on a timeline of what runs next. It draws the dashboard's scheduled refreshes, each delivery to a channel and your own subscription on one time axis. Select Day, Week or Month to set the span, and point at a run to read its time. A send that goes out shortly before a refresh turns amber, because it carries the data of the refresh before. In the sentence under the timeline, you read the name of the send and the fix: set the send after the refresh.

On Slack, if the workspace has no member with your email address, the form shows a field for your Slack member ID. Paste your member ID there.

A subscription can pause. Scheduled sends then shows the reason:

• You lost access to the dashboard. Ask its owner to share it again.
• The Slack workspace has no member with your address. Paste your member ID.
• The dashboard holds data the server cannot verify. Ask an editor to refresh the datasource once.

After the reason is gone, a paused subscription starts again at its next cadence.

A send that fails tries again after a few minutes, and then at longer gaps. When it fails six times in a row, the subscription stops retrying, and your inbox says so. Fix the cause, or wait until it is fixed, then select Send now in the panel, and the subscription starts again.

Your inbox

In the inbox, you see what happened on your dashboards while you were away. It has an entry when:

• someone starts a comment thread on a dashboard you own, or replies in a thread you are in,
• someone shares a dashboard with you, or hands one over to you,
• someone moves a dashboard you own or edit to the trash, and again a week before it deletes,
• a scheduled refresh of your dashboard stops,
• on an org install, one of your subscriptions pauses or fails,
• on an org install, a delivery is ready for your approval, if you hold the analyst right,
• on an org install, someone asks for access to a dashboard, a shared datasource or a file whose sharing you can change, or someone declines your own request (see Share a dashboard → Ask for access).

You get no entry for what you did yourself, or for what your agent did for you. Ten comments on one dashboard make one entry with a count, not ten entries.

1. In the header, select the Inbox button. Its badge shows how many entries you have not read.
2. Select a dashboard name to open the dashboard. Its entries are then marked as read.
3. To put an entry away, open its menu (⋯) and select Done. The entry moves to the Done view. Move to inbox brings it back.

An entry goes away by itself when its problem clears: a refresh that runs again, a subscription that sends again, a delivery someone sent, a dashboard someone restored. An entry stays for 90 days after its latest event.

To stop entries from one dashboard, open an entry's menu and select Mute this dashboard. Replies to you, and scheduled refreshes that run as you, still arrive, because only you can answer them. The panel lists your muted dashboards, each with Unmute.

Get your inbox by email or in Slack

When an entry in your inbox stays unread for 15 minutes, you can get a message about it: an email at the address you sign in with, or a Slack direct message. Entries that arrive together come in one message. Each message names the dashboard and what happened, and links to the dashboard. It never holds the text of a comment.

You need a server that sends these messages. When it does not, the Notifications section of Settings says so in one line, and your inbox in the app still shows every entry. Slack shows as a column only where the server sends to Slack. If Slack has no member at the address you sign in with, Slack messages do not reach you, and the Notifications section says so. To fix it, paste your Slack member ID at Subscribe on any dashboard.

1. Open the account menu at the top right, then Settings.
2. Go to Notifications, then Messages about your inbox.
3. Tick the kinds of entry you want, in the column of each channel. Each box saves when you change it. By default you get email when something needs you: a refresh or a send that stopped, a dashboard in the trash, and an access request. Comments and shares stay in the app until you tick them. Every Slack box starts off.
4. To go back to those defaults, select Reset to defaults.

An entry you read in the app before its message leaves is not in the message. A dashboard you muted sends you no messages either, except what still reaches your inbox: a reply to you, and a scheduled refresh that runs as you. If a save fails, the box goes back to what it was and a message names the cause. Select the box again.

Who can see it

Dashboards are private by default. On arkush.app, a dashboard is private to its owner, or published to the internet, where anyone can read the published copy and search engines can list it. Only an admin of arkush.app can share a dashboard with a named person.

On an org install, a dashboard opens for you because its owner, one of its editors, or an admin shared it:

• with you,
• with a group you belong to,
• or with everyone who can sign in to the org install. Where the admins named the organization's domains, that means the organization's members. A guest, such as a person at a partner company, then opens it only when the editor includes the guest's domain.

The link to a dashboard in the app gives no access by itself. A person you send it to needs the same access. On an org install, a person the dashboard refuses can ask for access on the page that refuses them. The owner gets the request in the inbox and answers it in the Share dialog.

When a dashboard was shared with you and you no longer need it, you can leave it, and it is no longer in your list. See Share a dashboard → Leave a dashboard shared with you.