---
title: "Klea, the assistant"
description: "Ask Klea questions about your store and let it make changes for you, with your approval."
url: "https://docs.poltura.com/en/assistant/"
lang: en
alternates:
  en: "https://docs.poltura.com/en/assistant/"
  hu: "https://docs.poltura.com/hu/assistant/"
---

# Klea, the assistant

Klea, the assistant in the admin: what it can do and what it asks before acting.

- Where: Sidebar → Assistant

## Articles in this area

- [Permissions and approvals](https://docs.poltura.com/en/assistant/permissions-and-approvals/): Choose how much Klea may change on its own and approve or decline the changes it asks about.
- [Agent requests](https://docs.poltura.com/en/assistant/agent-requests/): Decide the changes that Klea or a connected AI tool wants to make and that need your approval.
- [Connect Poltura to Claude, ChatGPT and more](https://docs.poltura.com/en/assistant/connect-ai-apps/): Add your store to Claude, ChatGPT or Perplexity in a few clicks, without a terminal, and choose exactly what the app may see and do.
- [AI agents and connected tools](https://docs.poltura.com/en/assistant/ai-agents/): Let AI tools such as Claude, ChatGPT and Cursor work in your store, choose which actions always ask you, and see or remove what is connected.
- [AI credits](https://docs.poltura.com/en/assistant/ai-credits/): See how many AI credits your store has, what uses them and how to buy more when they run low.
- [Using AI responsibly](https://docs.poltura.com/en/assistant/using-ai-responsibly/): What to check before AI-written text reaches your customers, which approval mode to choose, and what your customers are told.

Klea is the assistant built into the admin. You ask in your own words. It answers from your store's data or makes the change for you. Anything that changes the store waits for your approval, depending on the mode you choose.

## Before you start

- Klea is available on every plan, also while your store is private. It uses [AI credits](https://docs.poltura.com/en/assistant/ai-credits/).
- The Owner, Administrator, Store manager, Catalog editor and Support roles can use it. Finance and Read-only cannot.
- Klea can never do more than you can. Every action is checked against your own permissions.

## Ask a question

1. Select **Assistant** at the bottom of the sidebar, or press `⌘J` on a Mac or `Ctrl+J` on Windows. The Klea panel opens over the page.
2. Type your question or request. On an empty chat you can also pick a suggestion, such as **Summarize today's orders** or **Which products are low on stock?**
3. Press `Enter` to send. Use `Shift+Enter` for a new line.
4. Watch the answer arrive. While Klea works, a line says in plain words what it is doing. **Stop** ends the run.

After each answer Klea suggests what you could do next. Select a suggestion to continue.

You can also reach Klea from the ask box on [Home](https://docs.poltura.com/en/start/home/), from **Ask assistant about** in [search](https://docs.poltura.com/en/start/admin-basics/#search), and from the assistant tab in the [Customizer](https://docs.poltura.com/en/online-store/customizer/).

## Move, dock or enlarge the panel

The buttons in the panel header let you:

- **New chat**: start a fresh conversation.
- **Dock to the right**: fix the panel to the side of the page. **Undock** makes it float again.
- **Open full view**: open the full Assistant page.
- **Minimize**: shrink the panel to the **Ask Klea** button.

You can drag the floating panel to move it and drag its edge to resize it.

## Go back to an earlier conversation

1. Open the panel and select **Open full view**.

2. Find the conversation in the list on the left. Conversations are grouped by the day you last used them, newest first. Each gets a title by itself.

   ![The full Assistant page with Klea’s past conversations listed by day on the left and a New chat button at the bottom](https://docs.poltura.com/screenshots/en/assistant.webp)

   _New chat at the bottom starts a fresh conversation._

3. Use **Search conversations** to find one by name.

4. Select a conversation to continue it.

To remove one, choose **Delete conversation** beside it and confirm with **Delete**.

## Attach a file

Select **Attach files** in the message box, or drop the files onto it. Klea reads images (PNG, JPEG, WebP), PDFs and text files (TXT, Markdown, CSV), for example a supplier price list or a screenshot.

One message can carry up to 3 images, 2 PDFs and 3 text files. Images can be up to 4 MB, PDFs up to 25 MB and 200 pages, text files up to 2 MB.

## Answer Klea's questions

When a request could mean more than one thing, Klea asks instead of guessing. A card shows one to three questions with a few options each. Pick an option, choose **Something else…** to type your own answer, or **Skip**. Then select **Next**.

## What Klea can help with

- **Catalogue**: products, product setup and readiness, options and variants, product content (search titles, related products, badges), product page tabs and tables, categories, collections and tags, attributes, bundles and their economics.
- **Inventory** and **Digital** goods: stock levels, key pools, files and delivery.
- **Orders**: look-ups, fulfillment, payments and refunds, order edits and draft orders, preorders, returns and return cases, invoicing and order numbering, payment checks.
- **Customers**: customer records and groups, business accounts, wholesale and quotes.
- **Marketing**: promotions and campaigns, price lists, gift cards and loyalty, reviews and the newsletter.
- **Content**, **Media** and **Translations**: pages, blog posts and guides, the media library, translations.
- **Feeds**: marketplace and price comparison feeds, their rules and category mapping.
- **Storefront**: the Customizer (layout, pages and menus, style), themes and the theme code, and your email templates, campaigns and automations.
- **Store setup**: store settings, markets and currencies, tax and zones, shipping, alerts and checks, imports, forms and redirects, analytics.

Klea asks you before it changes things, according to the mode you choose. Some areas are only available when the matching feature or app is on for your store.

## Good to know

- Klea replies in the language you write in, whatever language your admin is set to.
- Klea is for running your store. It declines unrelated requests such as general essays, news or IT help. If it refused something that was about your store, select **This was wrong** to report it.
- Each conversation remembers its own messages. Nothing is carried over into a new chat.
- Design and code changes to your storefront are saved into the theme draft first. Customers see them only after you publish. See [Themes](https://docs.poltura.com/en/online-store/themes/#publish).
- AI store design and theme code changes with Klea are available on Plus and Pro once your store is open, not while it is private.
- Klea can make mistakes. Check anything important.
- The message box shows **Poltura AI**. Choosing a different model is not available.

## If something goes wrong

- **"The assistant is not available".** It is not switched on for this store. Ask your administrator.
- **"You do not have access to the assistant."** Your role does not include it. See [People and roles](https://docs.poltura.com/en/settings/organization/team/#roles).
- **"You've used all your AI credits for this billing period."** See [AI credits](https://docs.poltura.com/en/assistant/ai-credits/).
- **"This run hit its time limit and was stopped."** Send a shorter request, or ask Klea to continue.
- **"Too many requests right now."** Wait a moment and try again.

## Related

- [Permissions and approvals](https://docs.poltura.com/en/assistant/permissions-and-approvals/)
- [Agent requests](https://docs.poltura.com/en/assistant/agent-requests/)
- [AI agents and connected tools](https://docs.poltura.com/en/assistant/ai-agents/)
- [AI credits](https://docs.poltura.com/en/assistant/ai-credits/)
- [AI replies](https://docs.poltura.com/en/inbox/ai-replies/)
- [Customizer](https://docs.poltura.com/en/online-store/customizer/)
- [Translations](https://docs.poltura.com/en/online-store/translations/)
