# How to customize a Kaiya App

Kaiya Apps are not static once created. You modify them the same way you built them: through conversation. There is no drag-and-drop editor or configuration panel. All changes are made through natural language instructions in the Kaiya conversation.

1. Open the app you want to modify.
2. Click the **Customize** icon (Kaiya icon) in the top-right toolbar. This opens the Kaiya conversation panel in a split-pane view alongside the app.
3. Type your modification request in natural language at the bottom of the conversation panel.
4. Kaiya processes the instruction, and updates the app in the right panel.

#### What you can change

* Remove or add KPI cards
* Swap chart types (for example, change a bar chart to a line chart)
* Add or remove dimension filters
* Change time ranges or date filters
* Add, remove, or reorder sections (tabs)
* Change the theme or visual styling of the app
* Modify the insights or summaries

{% hint style="info" %}
Every modification is saved as a new version. Changes remain in draft until you explicitly publish. Version history is accessible from within the app, so you can review previous versions and roll back if needed.<br>
{% endhint %}

### How versioning works in Kaiya Apps

Kaiya Apps use a versioning system to track changes and control what other users see.

* **Draft versions:** When you customize an app, each save creates a new draft version. Draft changes are only visible to the person making the edits until the app is published.
* **Publishing**: Once you are satisfied with your changes, publishing the app makes the current version visible to all users who have access.
* **Published vs. Archived:** The Apps library supports two states. Published apps are actively available to users.&#x20;

### Permissions and Sharing

Kaiya Apps use the same explicit user and group permission model as Vizpads. When you create an app, you are its owner. You can share it with specific users or groups, granting them view/edit access.

Modifications made affect all users who have access to that app once the changes are published. There is no per-user customization layer; the published version is the same for everyone with access.

### Refreshing data on a schedule

In addition to triggering refresh manually from the toolbar (**Refresh app data**), you can configure automatic refresh on a schedule. Schedules are set in natural language inside the app conversation. Examples:

* *"Refresh this app every day at 6 a.m."*
* *"Update the data every Monday morning."*
* *"Refresh hourly."*
* *"Stop the scheduled refresh."*

**When the Business View changes**

A Kaiya App is bound to the Business View it was built from. When the Business View is updated with new data or refreshed aggregations, those changes appear in the app on the next refresh (manual or scheduled).

If the schema of the Business View changes after the app was built (columns added, removed, renamed, or retyped), the existing app's refresh is rejected because the app's data bindings no longer match. In that case, recreate the app to pick up the new schema.


---

# Agent Instructions: 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:

```
GET https://help.tellius.com/tellius-6.3/kaiya/kaiya-apps/how-to-customize-a-kaiya-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.