> For the complete documentation index, see [llms.txt](https://help.tellius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tellius.com/settings/vizpad/vizpad-settings.md).

# Vizpad Settings

Under **Settings → Modules → Vizpad → Vizpad Settings**, this page controls how Vizpads load, render, and behave for everyone in the workspace. Most of these settings trade performance against convenience, so the right values depend on your data volume and how heavily your users build.

<figure><img src="https://3138146484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM1pa9Nct9EmVU4Ol8Mol%2Fuploads%2FW5bbkIlysP3eycUQ86qu%2Fimage.png?alt=media&amp;token=acbcd20b-57db-42df-8431-b86d039c61b9" alt=""><figcaption></figcaption></figure>

### **Loading and performance**

**Vizpad Batch Count:** The number of widgets loaded in a single batch when opening a Vizpad. Higher values load more at once but can increase the initial load time. Allowed range: 4-8.

**Maximum Tabs:** The maximum number of tabs that can be created in a Vizpad.

**Maximum charts per tab:** The maximum number of chart-type visualizations allowed per tab. KPI, text, image, and similar widget types do not count toward this limit, so a tab can hold more widgets than this number suggests. Range: 25-50.

**Vizpad Sync Timeout:** The maximum wait time in seconds before Tellius switches to an asynchronous response (where browser stops waiting: the server keeps working in the background and delivers the result when it's ready). When a Vizpad takes longer than this to respond synchronously, the request continues in the background rather than holding the connection open.

**Enable Bulk Filter Config Apply:** Lets users add or remove several filters and columns in the **Configuration** pane at once, then use *Apply* or *Cancel* to save or discard all of them together. When disabled, the chart updates after every individual edit. Turn it on when users work with large or live datasets, where updating after each change is slow.

**Display "Apply" and "Undo" buttons when applying filters in a Vizpad:** Adds **Apply** and **Undo** buttons under **Apply** filters, letting users select several filter values before committing them. Like the setting above, this avoids re-querying after every selection, which matters on large or live datasets.

**Use compact chart scaling:** When enabled, charts use a tighter layout so more of each visualization fits inside its widget. Turn it off for standard chart padding and sizing.

**Disable Virtualization:** When enabled, all charts load immediately instead of using viewport-based lazy loading. Lazy loading normally renders only what's on screen and loads the rest as the user scrolls. Disabling it can improve compatibility but may reduce scroll performance on large Vizpads. Leave it off unless you're troubleshooting a rendering problem.

### Display Settings

**Enable "chart summary and tab summary" options in vizpad:** Shows the summary settings and the **Add tab summary** option on Vizpads, letting users add Kaiya-generated, customizable summaries to charts and tabs. Turning it off removes both options.

**Numeric**, **Text**, and **Date:** Sets the default column alignment for each data type in table visualizations. Each offers **Left Aligned**, **Center Aligned**, or **Right Aligned**.

{% hint style="info" %}
The conventional choices are right-aligned numbers, so digits line up by place value and are easy to compare down a column, and left-aligned text and dates, so they read naturally.&#x20;
{% endhint %}

### **TQL Job**

TQL (Tellius Query Language) jobs are the queries Tellius runs behind the scenes when a user loads a Vizpad, applies a filter, or refreshes a chart. Because a single busy Vizpad can fire many of them at once, these settings cap how many run concurrently so heavy usage doesn't overload the system.

**Enable Queueing:** When enabled, TQL jobs are queued to prevent system overload. When off, every request is processed instantly, which can clog the service under load.

<figure><img src="https://3138146484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM1pa9Nct9EmVU4Ol8Mol%2Fuploads%2Fu71VPNJGOWuNrRhce7UD%2Fimage.png?alt=media&amp;token=89fe2fbc-0915-44d1-bebb-16988473c6d4" alt="" width="563"><figcaption></figcaption></figure>

Turning this on reveals four fields.&#x20;

**Global Quota:** The maximum number of TQL jobs that can run concurrently across all users.

**User Quota:** The maximum number of TQL jobs that can run concurrently per user. This prevents any one user from consuming all available slots.

**Queue Quota:** The maximum number of queued, pending TQL jobs allowed per user. Once a user hits this limit, their new submissions are blocked until a queued job starts or is cancelled.

**Queue Timeout (seconds):** The maximum time a request can wait in the queue before being cancelled. The user is notified when load is high.

{% hint style="info" %}
Global Quota is the system-wide ceiling on running jobs, User Quota stops one person monopolizing it, Queue Quota caps how much any one person can stack up waiting, and Queue Timeout stops requests waiting indefinitely.
{% endhint %}

### **Vizpad Excel Export**

Sets the maximum limits for each Excel export. These limits apply globally across all Vizpad exports, and data beyond each limit is truncated.

<figure><img src="https://3138146484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM1pa9Nct9EmVU4Ol8Mol%2Fuploads%2Fs3cFZNR4cfqZC0FGRpwf%2Fimage.png?alt=media&amp;token=8268355a-cf0f-405e-bd4a-4540535e2bf9" alt="" width="563"><figcaption></figcaption></figure>

**Maximum sheets in a workbook:** Range 1–50.

**Maximum records per sheet:** Range 1–1,000,000.

**Maximum columns per sheet:** Range 1–16,384.

The upper bounds on records and columns match Excel's own hard limits, so raising them beyond these values isn't possible.

{% hint style="warning" %}
When a table export exceeds the row limit, users can retrieve the rest in successive batches from the chart's own export dialog, using **Custom row range**. See [How to export more than 100,000 rows](https://help.tellius.com/vizpads-explore/actions-in-view-mode/exporting-charts-and-vizpads/how-to-export-more-than-100-000-rows).
{% endhint %}

#### Saving

Click **Save** to apply your changes, or **Cancel** to discard them.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.tellius.com/settings/vizpad/vizpad-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.