Documentation

Ataytis Matrix documentation.

Build, format, and publish demanding tabular reports with the Ataytis Matrix Power BI visual.

Format pane

Toolbar

Choose which tools report readers get — search, export, comments, notes, annotation, quick calculations, grouping — and style every button.

You decide what readers can do

The toolbar is the visual's interface for report readers, and it is entirely opt-in. Every button is switched on individually, and each carries its own text, icon, position, size, corner radius, font, colours, and borders. A report published with search and export gives readers exactly those two things; nothing else appears.

The Ataytis Matrix toolbar with several buttons enabled, showing arrangement and sizing.
The toolbar as readers see it. Every button here was switched on deliberately; the rest stay hidden.

Search filters the matrix to rows matching what the reader types. It is the single most useful tool on a long table.

SettingWhat it does
Show search target selectorLets readers choose which field they are searching.
Target selector hintHelper text explaining that selector.
Show clear buttonAdds a control to reset the search.
Search up to rowsHow many rows are searched. Zero searches everything currently loaded.
Placeholder textThe prompt shown in the empty search box.
Search box width / height / corner radius / fontSizing and type for the box.
Background, border, border width, text color, placeholder colorAppearance of the search box.
Target selector width, Clear button textSizing and labelling for the two sub-controls.

Result count

A counter showing how many rows are loaded and how many exist in total, so a reader is never misled by a partially loaded matrix. Loaded rows and Total rows each have their own label and position, with a separator between them, plus the usual font, colour, sizing, and border controls. Total rows uses the measure in the Total rows field well.

Export and copy

Four ways out of the visual. Copy values puts the matrix on the clipboard so it can be pasted straight into Excel, an email, or a document — no file, no download, and no dependency on tenant download policy. The three export formats each write a file, and each has its own button and settings group: XLSX and PDF carry the visual's formatting and number formats through, while CSV is there for when someone just wants the values.

ActionProducesKeeps formatting
Copy valuesClipboard content, pasteable anywhereValues and structure
Export XLSXAn Excel workbookYes — styling and number formats
Export CSVA plain comma-separated fileNo, by design
Export PDFA paginated documentYes — styling, number formats, and layout
SettingApplies toWhat it does
Max cellsAll threeCaps how much is written in one export.
Show totalsAll threeWhether subtotal and grand total rows are included.
Show loading text / Loading textAll threeFeedback while a large export is being assembled.
OrientationPDFPortrait or landscape.
Repeat headersPDFRepeats column headers on every page.
Include page numbersPDFNumbers the pages.
Include title / Title textPDFA heading on the exported document.
Include export datePDFStamps the document with the date it was produced.
Include logoPDFSwitches the logo on.
Logo data URLPDFThe image itself, supplied as a base64 data URL rather than a file path or web address — see the note below.
Logo sizePDFHow large the logo is rendered on the page.
Logo positionPDFTop left, Top right, Bottom left, or Bottom right.
The PDF export settings for Ataytis Matrix alongside the resulting exported document.
PDF export options and the document they produce, including title, logo, and date stamp.

Notes, comments, highlighting, and annotation

Four related tools let readers record why a number is what it is, rather than losing that context in email.

ToolWhat it provides
Notes columnAn extra column readers type free text into, switched on with Show notes column. It has its own title, width, styling, and can sit to the Left or Right of the matrix. Use it for the one-line explanation that would otherwise be lost.
Comments panelA side panel holding threaded comments against the matrix. Fully configurable — its position, size, colours, fonts, and the variance icon it shows (Triangle, Arrow, Chevron, Circle, or none) are all settings, so it can sit wherever suits the report layout.
HighlightLets readers mark individual cells to draw the eye, without changing any data.
AnnotationFreehand pen and highlighter drawing over the visual, which works in the Power BI Service as well as Desktop.

What persists, and what does not

This is the part worth understanding before you rely on these tools, because notes and annotations behave differently depending on where they were made.

Where it was addedWhat happens to it
In Power BI Desktop, then publishedSaved with the report. Every reader sees it, exactly as authored.
In the Power BI Service, in edit mode, then savedSaved with the report in the same way. This is how you add a note that needs to stick without reopening Desktop.
In the Power BI Service, in reading viewAvailable for that session only. The reader can add, use, and see it, but it is gone when they leave.
Ataytis Matrix with the comments panel open beside the matrix showing an existing comment.
The comments panel, opened from the toolbar. Its position and styling are configurable.

Quick calculations, grouping, and the rest

ToolWhat it provides
Quick calculationsA menu of calculations readers can apply themselves. Like every other button, it can be hidden from readers entirely.
GroupingCollects several toolbar buttons behind one control, so a busy toolbar stays tidy. Each button can be given its own button or placed in one of up to six menus, and the menu marker can be a Chevron, Triangle, Plus, Dots, or nothing.
Density pickerLets readers switch between Compact and Comfortable row spacing themselves.
Expand/collapseButtons to expand or collapse the whole hierarchy at once, each with its own label.
Copy buttonCopies the matrix to the clipboard, which is the fallback when tenant policy blocks downloads.

Button styling and layout

The Button styling group sets defaults for every button at once. The Layout group places the toolbar at the Top, Bottom, Left, or Right of the visual, aligns the buttons within it (Left, Center, Right, or Space between), and spreads them across up to six rows. Toolbar options carries the remaining toolbar-wide switches. Individual buttons keep their own overrides, so you can set a house style and then make one button deliberately different.

Every button also takes an icon from a shared set — copy, export, download, share, note, comment, edit, annotate, highlight, calculator, percent, sort, filter, search, and others — positioned Left of text, Right of text, Icon only, or omitted.

Toolbar — Ataytis Matrix | AtaytisTech