monday.com administration app · by Quirk

Instance X-ray for monday.com

See every board in your account on one map, find what’s broken or forgotten, and fix it in bulk, with a preview before anything changes.

monday.com · Administration · Instance X-ray
Instance X-ray after a scan: health score 52, 46 active boards, 44 links and 33 findings above a map of every board coloured by last use, with Biggest wins in the side panel
Every boardOne scan reads every board you can open
11 checksA health score out of 100, and the fixes that raise it most
Impact firstSee what depends on a board before it’s archived
Preview, then fixBulk fixes show every change first, with undo
Overview

What Instance X-ray does

monday.com shows you one board at a time. Instance X-ray is for account admins: it reads every board you can open, draws the whole account on one map, and lists what needs attention, such as boards with no active owner, links to boards that are gone, and boards nobody has used for six months.

The scan only reads. Nothing in your account changes until you choose a fix, check its preview and confirm it.

Quick start · about 2 minutes

Get started in 4 steps

Tick each step as you go. Your progress is saved in this browser.

  1. Install the app

    Install Instance X-ray from the monday.com apps marketplace. You need to be an account admin. Pro comes with a 14-day free trial.

  2. Open it from Administration

    In monday, open Administration, then Administration apps, then Instance X-ray.

  3. Click Scan my account

    The scan reads every board you can open: names, owners, links, item counts and when each was last used. A large account takes a minute or two.

  4. Explore

    Start with Biggest wins in the side panel, then click any board on the map. The scan is saved, so other admins can open it without scanning again.

0 of 4 done
The header says who took the scan and when. Scan again takes a new one: any time on Pro, once a month on Free.
The screen

A tour of the main screen

Click a numbered marker to see what each part does, or step through them in order.

The Instance X-ray screen with numbered markers
    Seeing the account

    The account map

    Every board is a circle, sized by how many items it has. Lines show how boards are linked: connect boards and mirror columns, dependencies between boards, and automations that write to another board. Hover over a board for its details, and click it to open its panel.

    Use the Colour menu to change what the colours mean. The legend under the map only lists the colours in use.

    The same map with Colour: Findings: each board takes the colour of its most serious finding.

    Colour by

    ColourWhat the colours mean
    Last usedThe default. Used in the last 30 days, 30 to 90 days, 90 to 180 days, over 180 days, or not known.
    FindingsEach board’s most serious finding: fix soon, worth a look, tidy up, or nothing flagged.
    OwnershipHas an active owner, only deactivated owners, or no owner.
    WorkspaceYour nine biggest workspaces each get a colour; the rest are “Other workspaces”.
    Board typeBoards, portfolios, projects, docs and workflows.
    PrivacyMain (everyone in the account), private, or shareable.
    Guest accessGuests have access, no guests, or not checked.

    The default colours, and the lines

    Used in the last 30 days
    Used 30 to 90 days ago
    Used 90 to 180 days ago
    Not used for over 180 days
    Not known
    Connect boards column
    Mirror column
    Dependency
    Automation that writes to another board

    Finding your way around

    • Find a board searches by name.
    • Show picks what’s drawn: boards and projects (the default), boards only, portfolios, projects, docs, workflows, or everything.
    • All workspaces narrows the map to one workspace. Include archived adds archived boards.
    • The buttons in the corner zoom in and out, fit the map to the screen and arrange it again. The full-screen button covers the app with the map; Esc returns.
    • The Boards tab lists the same boards as a table you can filter, sort, tick and download as CSV.
    Classic dashboards aren’t available through monday’s API, so they can’t be shown on the map.
    Seeing the account

    What depends on a board

    Click any board, on the map or in the board list, to open its panel. It shows the board’s workspace, items, when it was last used and its owners, then two lists:

    • What depends on it: the boards that link to this one, and how.
    • What it links to: the boards this one reads from.

    Check What depends on it before you archive or delete a board. If other boards link to it, their connect-boards and mirror columns go blank once it’s gone.

    Show on map highlights the board and its links. Open board opens it in monday. The fix buttons (Assign owner, Move, Archive and Ask owner) are part of Pro.

    Finding what needs attention

    Health score and findings

    The Health score is out of 100: the share of your active boards with nothing flagged, less up to 20 points for things to fix soon (boards with no active owner, and links to boards that are gone). Click the Health score card for the breakdown.

    Biggest wins

    Biggest wins lists one fix for each kind of finding that lowers the score, ranked by the points it would win back, and shows the score you’d reach. As you fix them, each win shows how far along it is, such as “3 of 11 fixed”, and the points you’ve earned.

    Points are only earned by fixing: the score moves when the boards change, not when you tick something off.

    The findings list

    The Findings tab groups every finding by kind. Filter by Fix soon, Worth a look or Tidy up, or by kind, and download the list with CSV. Kinds with a fix have a button beside their heading, such as Archive all or Rename all.

    The 11 kinds of finding

    Five kinds lower the score. The other six are worth knowing about but don’t change it. Pick one to see what it looks for and what to do.

    Only active boards are judged. Docs, subitem boards and archived or deleted boards are on the map for context, but aren’t counted.
    Finding what needs attention

    Automation insights

    The Automations tab shows how many automations the account has, how many ran and failed in the last 7 days, and how many actions they used, with a monthly estimate. Below that are six lists:

    • Using the most actions: the busiest automations. Actions count against your plan’s monthly allowance.
    • Failing: runs that failed or gave up, with monday’s error, such as “Board not found”.
    • Running on unused boards: still switched on, on boards that are archived, deleted or unused for six months.
    • Made by people who’ve left: their creator has been deactivated, so they can stop without warning.
    • Pointing at missing boards: they read from or write to a board that’s gone, or monday marks their settings as invalid.
    • Same automation on many boards: copies on 3 or more boards that one cross-board workflow could replace.
    Automations come from a part of monday’s API that isn’t public yet. If monday doesn’t let the app read them, the tab says so; the rest of the scan still works.
    Fixing it

    Bulk fixes, with a preview and undo Pro

    Start a fix from wherever you find the problem: tick boards in the Boards tab, use the buttons in a board’s panel, a finding’s Archive all, Move all or Rename all, a Biggest wins button, or Hand over beside a deactivated owner.

    FixWhat it doesUndo
    Assign ownerOne person for all the ticked boards, or a different person per board. Optionally removes deactivated owners.✓
    ArchiveArchives the ticked boards, showing which are still linked from other boards first. Needs an extra tick to confirm.From monday’s archive
    MoveMoves boards to another workspace or folder.✓
    RenameStarts from a suggested name without “Copy of” or a trailing number, and can add a prefix to many names at once.✓
    Hand overGives a deactivated owner’s boards a new owner, and can subscribe that person to the boards the leaver followed.✓
    Ask ownersSends each owner of the ticked boards one monday notification with your note and their boards.Can’t be taken back

    How a fix runs

    Every fix uses the same dialog. Step through it:

    Assigning an owner to the boards with no active owner. Each board can have its own new owner, or use Set ticked boards to for all of them.
    The results list every change. Download what changed saves it as CSV, and Undo puts it back.

    Rename unclear boards

    The Unclear board name finding’s Rename all opens the rename fix. Each board starts with a suggested name, with “Copy of” and trailing numbers taken off; edit it, or add the same prefix to every ticked name. The preview warns when a new name is already used in the same workspace, and leaves unchanged names alone.

    Hand over a leaver’s boards

    The side panel’s Board owners list flags owners who have been deactivated. Hand over opens their boards with a new owner to choose for each. Find boards they followed also lists the boards the leaver subscribed to without owning, so the new person can be subscribed to them too.

    monday doesn’t let apps move automations. The handover lists the leaver’s automations with a link to each board, so you can take them over in monday and keep them working.

    Ask owners about their boards

    Ask owners is on the board list, a board’s panel, and the unused, long-unused and empty board findings. Each active owner of the ticked boards gets one monday notification from you, with your note (up to 500 characters) and their boards: ten by name, then a count. Clicking it opens the first board. Nothing on the boards changes, and notifications are sent only when you click Send.

    AAExample notification from Ada Admin
    We’re tidying up monday. Can these boards be archived? Reply by Friday if you still need one.

    Boards: Site diary (last used 220 days ago); Xmas party (last used 315 days ago).
    Notifications can’t be taken back, so Ask owners has no undo. It’s still recorded in the fix log.
    Showing the progress

    History, the fix log and the leadership report Pro

    The History tab charts the health score across every scan, with each scan’s score, active boards, links and findings. Below it, the Fix log lists every fix and undo made in the app: who made it, when, and what changed on each board, or monday’s message if it couldn’t be made. Fix log CSV downloads it.

    The leadership report

    Report in the header (or Leadership report on the History tab) downloads a one-page summary with your account’s name and logo: the score and how it has moved, findings by kind, what to fix soon, fixes since the scan, what the scan couldn’t see, and an offer of a Quirk optimisation review. Open it in a browser and print it to PDF.

    On Free, the History tab explains Pro instead, and keeps recording each scan’s summary so the chart is ready if you upgrade.
    Plans

    Plans

    Seeing your account is free. Fixing it, and showing the progress, are Pro. Pro is US$39 a month (US$33 a month billed yearly) for the whole account, with a 14-day free trial. Plans and billing are handled by monday.com: upgrade from any Upgrade button in the app.

    FeatureFreePro
    Price (US dollars)$0$39 a month, or $33 a month billed yearly
    New scansOne a month, shared by every adminAny time
    The account map and the impact check✓✓
    Health score, findings and Biggest wins✓✓
    Automation insights✓✓
    CSV downloads and the saved scan✓✓
    Bulk fixes with preview and undoPreview only✓
    Ask ownersPreview only✓
    History, fix log and leadership report–✓
    On Free, every fix opens with its full preview, and Upgrade to Pro to fix in bulk takes the place of the confirm button.
    Help

    Troubleshooting and FAQ

    Some boards are missing from the scan

    monday only shows an admin the boards they can open. Private and shareable boards you haven’t been invited to aren’t in your scan, and links to them show as “a board you can’t see”. When another admin opens a saved scan, boards they can’t open are hidden, and the notes button in the header says how many.

    Scan again is greyed out

    Free includes one new scan a month for the whole account, 30 days from the last one. The date of the next scan is shown beside the button. You can still open the saved scan, and Pro scans any time.

    The Automations tab says monday didn’t let it read automations

    Automations come from a part of monday’s API that isn’t public yet, and monday sometimes refuses it. The tab lists what each check returned. Everything else in the scan works as normal.

    A fix failed on some boards

    The results list monday’s own message for each board that couldn’t be changed, for example when you aren’t allowed to change that board. The other boards are still changed. Fix the cause in monday, then run the fix again for the boards that are left.

    How do I undo an archive?

    The app can’t undo an archive, so archiving asks for an extra tick. Restore the board from monday’s archive; its links work again once it’s back.

    Why aren’t dashboards on the map?

    Classic dashboards aren’t available through monday’s API, so the app can’t read them.

    Who can use it?

    Account admins. It’s an Administration app, opened from Administration → Administration apps.

    Trust

    Your data

    The scan runs in your browser. It reads your account’s boards, workspaces, users, automations and account name through monday’s API, using the permissions of the admin who runs it.

    To let other admins open the latest scan, it’s saved on monday code, monday.com’s own hosting, in your account’s region: board, workspace and user names and ids, links, item counts and dates. The app also keeps a summary of each scan (counts only) and a log of each fix made in the app (who made it, when, and the boards changed). We don’t use this data for anything else and never share it.

    Uninstalling the app deletes all of it, except the date of the last scan, which is kept so Free’s monthly scan still applies. Notifications are sent only when an admin chooses Ask owners and writes the note. See our Privacy Policy and Terms of Service.

    Need a hand?Quirk builds and supports Instance X-ray, and we’re a monday.com partner. Book an optimisation review and a Quirk consultant will walk through your scan, plan the clean-up and fix the links that matter.
    Contact Quirk →