# Monokaido manual

> Monokaido is a multi-tenant product information management (PIM) and e-commerce platform. This is its public manual: how every screen of the admin works, and the Universal Commerce Protocol (UCP) API through which AI agents and partner platforms discover a shop, search its catalog, build carts and checkout sessions, and hand the buyer over to the shop’s own checkout to pay.

The manual is published in Slovak (/sk/) and English (/en/); the links below are the English chapters. To integrate an agent with a shop’s UCP API, start with the OpenAPI document and the full UCP guide.

## Agentic commerce API (UCP)

- [Agentic commerce (UCP)](https://help.monokaido.com/en/ucp): What the Universal Commerce Protocol is, what Monokaido supports, and how an AI agent's purchase runs from product search to the order.
- [Turning UCP on for a shop](https://help.monokaido.com/en/ucp/merchant-setup): What a shop needs, where UCP is switched on, how to check it works, and what changes for customers.
- [Developer quickstart](https://help.monokaido.com/en/ucp/quickstart): A whole UCP purchase step by step — curl, JavaScript and Python, from the shop's profile to handing the checkout to the buyer.
- [Concepts and lifecycle](https://help.monokaido.com/en/ucp/concepts): The business profile, the UCP-Agent header, capability negotiation, carts and checkouts, statuses, money, languages and the continue_url handoff.
- [API reference (OpenAPI)](https://help.monokaido.com/en/ucp/api-reference): Every UCP endpoint, header, field and response — OpenAPI 3.1 to download for Swagger, Postman and client generators.
- [Errors and messages](https://help.monokaido.com/en/ucp/errors): The difference between a protocol error and a message in the answer, every code, and what a client should do about each.
- [Idempotency, concurrency and limits](https://help.monokaido.com/en/ucp/reliability): Idempotency-Key, retrying requests, concurrent writes, rate limits, session lifetimes and caching.
- [Security and data protection](https://help.monokaido.com/en/ucp/security): What UCP accepts and stores, how buyer data is protected, why it never handles payments, and how each shop is kept apart.
- [For AI agents](https://help.monokaido.com/en/ucp/ai-agents): A machine-readable description, tool definitions for function calling, and the rules an AI agent should follow in a shop.
- [UCP conformance](https://help.monokaido.com/en/ucp/conformance): Which parts of UCP 2026-04-08 Monokaido implements, which it does not, and what that means for an integration.
- [UCP FAQ](https://help.monokaido.com/en/ucp/faq): Answers to merchants' and developers' questions — from payments and testing to several shops and languages.
- [OpenAPI 3.1 document (JSON)](https://help.monokaido.com/ucp/openapi.json): Every UCP endpoint, header, field and response, importable into Swagger Editor, Postman, Insomnia and openapi-generator.
- [OpenAPI 3.1 document (YAML)](https://help.monokaido.com/ucp/openapi.yaml): The same document in YAML.
- [Agent tool definitions (JSON)](https://help.monokaido.com/ucp/tools.json): Tool definitions for LLM function calling that map onto the UCP operations.
- [Full UCP guide for LLMs](https://help.monokaido.com/ucp/llms-full.txt): The whole UCP developer guide as one Markdown file, for an agent’s context.
- [This index](https://help.monokaido.com/llms.txt): The manual’s chapters for language models, in the llms.txt format.

## Getting started

- [Getting started](https://help.monokaido.com/en/getting-started): What Monokaido does, how the application is laid out, and the path from the first sign-in to the first export.
- [Signing in and your account](https://help.monokaido.com/en/getting-started/signing-in): Signing in, registering, a forgotten password, and what to do when the system logs you out mid-task.
- [Setting up the company](https://help.monokaido.com/en/getting-started/company-setup): The first screen after registering: choosing a package, the trial, and what the choice switches on.
- [Finding your way around](https://help.monokaido.com/en/getting-started/finding-your-way): The top menu, switching companies, settings, the footer — and the question mark that brings you here.
- [Subscription and limits](https://help.monokaido.com/en/getting-started/subscription): What a package includes, how to change it, what happens when a limit runs out, and where the invoices are.

## Dashboard

- [Dashboard](https://help.monokaido.com/en/dashboard): The landing screen: what each number means, which warning needs acting on now, and where it leads.

## Products

- [Products](https://help.monokaido.com/en/products): How a product is born from a feed, what it passes through, and in what state it reaches the shop.
- [The product list](https://help.monokaido.com/en/products/product-list): Filters, search, columns, selecting several products, and the bulk actions that run over a selection.
- [Product detail](https://help.monokaido.com/en/products/product-detail): Everything the system knows about a product — including the raw feed data and where each value came from.
- [Editing and creating a product](https://help.monokaido.com/en/products/editing-a-product): Editing a product by hand, creating one without a feed, and the rule that decides whether an import overwrites your change.
- [Changes to review](https://help.monokaido.com/en/products/changes-to-review): The queue of changes an import brought in — what changed, how to compare it, and what approving means.
- [Merging duplicates](https://help.monokaido.com/en/products/duplicates): How the system finds the same product across several vendors, what exactly a merge does, and how to undo it.
- [Splitting products](https://help.monokaido.com/en/products/splitting): How one feed product becomes several, what the derived products are allowed to keep, and how to reverse the whole thing.
- [X Sales](https://help.monokaido.com/en/products/x-sales): Cross-selling and accessories: which products are offered together and how the links are made.
- [Product flows](https://help.monokaido.com/en/products/product-flows): The chain of steps a product goes through after import — what can be added, in what order, and how a flow is run.
- [Brands](https://help.monokaido.com/en/products/brands): Unifying manufacturer names across feeds, logos, and the margin set at brand level.
- [Photo studio](https://help.monokaido.com/en/products/photo-studio): Editing product photography with AI — one at a time or in bulk, including style and background settings.

## Parameters

- [Parameters](https://help.monokaido.com/en/parameters): How mismatched names and values in feeds become one consistent parameter table — and in what order it happens.
- [System overview](https://help.monokaido.com/en/parameters/system-overview): Parameter coverage across the catalogue: what is mapped, what is missing, and where it hurts most.
- [Managing parameters](https://help.monokaido.com/en/parameters/managing-parameters): Parameter values on individual products — what is filled in, what the vendor sent, and what the system made of it.
- [Filling in values](https://help.monokaido.com/en/parameters/filling-values): Filling missing parameters in a grid, AI extraction from the description, and the toggle that decides about overwriting.
- [Parameter translations](https://help.monokaido.com/en/parameters/translations): Translating parameter names and values into the shop's languages — in bulk or one by one.
- [Parameter definitions](https://help.monokaido.com/en/parameters/parameter-definitions): The parameters your catalogue knows: type, unit, example values, and the context handed to the AI.
- [Parameter mappings](https://help.monokaido.com/en/parameters/parameter-mappings): Matching names from feeds to your parameters — AI suggestions, confirmation, and what happens to the unmapped.
- [Value mappings](https://help.monokaido.com/en/parameters/value-mappings): Unifying the values of one parameter: "čierna", "black" and "BK" as a single value.
- [Parameter templates](https://help.monokaido.com/en/parameters/templates): The prescription of which parameters a product in a category should carry — and how completeness is measured against it.
- [Rules](https://help.monokaido.com/en/parameters/rules): Conditional "if this, then that" rules — when they are evaluated and in what order.
- [Bulk actions](https://help.monokaido.com/en/parameters/bulk-actions): Changing many products at once: choosing the scope, previewing the impact, and what can be undone.

## Categories

- [Categories](https://help.monokaido.com/en/categories): The difference between a vendor's categories and your own tree — and why they are kept apart.
- [The category tree](https://help.monokaido.com/en/categories/category-tree): Your own tree: creating, moving, activating a branch, and the settings children inherit.
- [Categories by vendor](https://help.monokaido.com/en/categories/by-vendor): Categories as the feed sends them — grouped by vendor, with a count for each.
- [Manual categories](https://help.monokaido.com/en/categories/manual-categories): Managing the categories you created — their order, the mappings pointing into them, and the template they carry.
- [Category mappings](https://help.monokaido.com/en/categories/mappings): Matching a vendor's categories to your tree — AI suggestions, bulk confirmation, and the effect on products.
- [Storefront preview](https://help.monokaido.com/en/categories/storefront-preview): How a category and its products look to a customer — before any of it goes live.

## E-commerce

- [E-commerce](https://help.monokaido.com/en/ecommerce): What the shop module adds, how it is switched on, and which screens come with it.
- [Shop analytics](https://help.monokaido.com/en/ecommerce/analytics): Revenue, orders and conversion over time — and how to read the comparison periods.
- [Orders](https://help.monokaido.com/en/ecommerce/orders): The order list and detail, status changes, documents, and what the customer is sent at each step.
- [Carts](https://help.monokaido.com/en/ecommerce/carts): Open and abandoned carts — what is in them and when they are discarded.
- [Customers](https://help.monokaido.com/en/ecommerce/customers): Customer accounts, order history, addresses, and the loyalty balance.
- [Newsletter](https://help.monokaido.com/en/ecommerce/newsletter): Contacts who signed up for news in your shops — where they come from, the export for mailing services, unsubscribing and erasing.
- [Contact forms](https://help.monokaido.com/en/ecommerce/contact-forms): What shoppers sent through the forms of your shops — product inquiries (in catalog mode or below the Add to cart button) and the Contact form section: the list, the detail, the link to the customer and deleting.
- [Storefronts and access keys](https://help.monokaido.com/en/ecommerce/storefronts): One catalogue, several shops: domain, language, currency, and the key a shop connects with.
- [Storefront design](https://help.monokaido.com/en/ecommerce/storefront-design): The storefront design editor: home page sections, shop style, colours, corner radius, buttons, Monokaido AI proposals and publishing.
- [Shipping](https://help.monokaido.com/en/ecommerce/shipping): Shipping methods, their price, free shipping, and pickup points.
- [Payments](https://help.monokaido.com/en/ecommerce/payments): Payment methods, connecting a payment gateway, fees, and what happens when a payment fails.
- [Order statuses](https://help.monokaido.com/en/ecommerce/order-statuses): Mapping ERP status codes onto the system order statuses.
- [Discounts and coupons](https://help.monokaido.com/en/ecommerce/discounts): Discount types, the conditions to qualify, whether they stack, and usage limits.
- [Loyalty programme](https://help.monokaido.com/en/ecommerce/loyalty): Credits earned on purchases, their expiry, and the reward tiers customers exchange them for.
- [Shop integrations](https://help.monokaido.com/en/ecommerce/integrations): Connections to outside services — measurement, marketing, and carriers.
- [Checkout consents](https://help.monokaido.com/en/ecommerce/checkout-consents): Consent checkboxes at checkout: the wording, whether they are required, and where the proof is kept.
- [Content generator](https://help.monokaido.com/en/ecommerce/content-generator): AI-written copy for the shop's categories and landing pages.
- [Banners](https://help.monokaido.com/en/ecommerce/banners): Image blocks on the home page and in categories — placement, validity, and where they lead.
- [Trust elements](https://help.monokaido.com/en/ecommerce/trust-elements): Icons and claims such as "free shipping" or "30-day returns", and where they appear in the shop.
- [Announcement bar](https://help.monokaido.com/en/ecommerce/announcement-bar): The strip above the shop header: wording, colour, validity, and whether a customer can dismiss it.
- [Shop pages](https://help.monokaido.com/en/ecommerce/pages): Terms, about us, contact — static pages and their addresses.
- [Email templates](https://help.monokaido.com/en/ecommerce/email-templates): The wording of automatic customer emails, their variables, and the preview before sending.
- [Parameters in the shop](https://help.monokaido.com/en/ecommerce/storefront-parameters): Which parameters are visible in the shop, which are filterable, and in what order they are listed.
- [Shop settings](https://help.monokaido.com/en/ecommerce/settings): The shop's identity, order numbering, tax, stock, and checkout rules.
- [Shop translations](https://help.monokaido.com/en/ecommerce/storefront-translations): The shop's interface wording in your languages — what can be overridden and what is translated automatically.

## Blog

- [Blog](https://help.monokaido.com/en/blog): Why a PIM has a blog, how it connects to the catalogue, and what the module adds.
- [Blog overview](https://help.monokaido.com/en/blog/dashboard): The state of drafts, the publishing schedule, and what is waiting for approval.
- [Articles](https://help.monokaido.com/en/blog/articles): Writing and editing an article, images, linking to products, and publishing.
- [Sections](https://help.monokaido.com/en/blog/categories): Grouping articles into sections and their addresses in the shop.
- [Topic pool](https://help.monokaido.com/en/blog/topic-pool): The queue of topics articles are generated from — how it is filled, approved and worked through.
- [Authors](https://help.monokaido.com/en/blog/authors): The author profiles shown alongside articles.
- [Tags](https://help.monokaido.com/en/blog/tags): Free-form labelling of articles across sections.
- [Blog settings](https://help.monokaido.com/en/blog/settings): Generation frequency, article length and tone, and the approval mode.

## Exports

- [Exports](https://help.monokaido.com/en/exports): How the catalogue becomes an outbound feed for comparison sites and partners.
- [Outbound feeds](https://help.monokaido.com/en/exports/feeds): Creating a feed, choosing products and categories, the output format, and the address you hand to a partner.

## Settings & operations

- [Settings & operations](https://help.monokaido.com/en/settings): Where the company, the vendors and the operations are configured — and where to look when something did not finish.
- [Company and account](https://help.monokaido.com/en/settings/company-and-account): Company details, logo, notifications, interface appearance, and switching between companies.
- [The team and roles](https://help.monokaido.com/en/settings/team): Inviting a colleague, what each role may do, removing access, and accepting an invitation.
- [Feed mapping](https://help.monokaido.com/en/settings/feed-mapping): Matching feed fields to product fields, vendor mappings, availability, and replacing an uploaded file.
- [Vendors and imports](https://help.monokaido.com/en/settings/vendors): Adding a vendor, feed types, the download schedule, and what the states next to the last import mean.
- [Subvendors](https://help.monokaido.com/en/settings/subvendors): Supplementary data sources for existing products — matching, value precedence, and priority.
- [Transfers to other systems](https://help.monokaido.com/en/settings/transfers): Handing products to an ERP or a shop, the direction, the schedule, and the live run.
- [Social media](https://help.monokaido.com/en/settings/social-media): Product posts for Instagram and Facebook — a branded image, AI text, and publishing to your Page.
- [Warehouses](https://help.monokaido.com/en/settings/warehouses): Warehouses and their stock, how they map to vendors, and their effect on shop availability.
- [Regions](https://help.monokaido.com/en/settings/regions): The countries and regions you sell to — currency, tax, and the shipping tied to a region.
- [Custom product statuses](https://help.monokaido.com/en/settings/product-statuses): Your own statuses beyond the built-in ones — what they are good for and where they filter.
- [Transfer logs](https://help.monokaido.com/en/settings/transfer-logs): What was handed to connected systems, when, and with what result — including the XML that was sent.
- [Background processes](https://help.monokaido.com/en/settings/background-processes): Long-running tasks — what is running, what is queued, what failed, and what actually changed.
- [Daily summary](https://help.monokaido.com/en/settings/daily-summary): The screen that shows the same numbers as the daily email — and states how each one is counted.
- [Exchange rates](https://help.monokaido.com/en/settings/exchange-rates): The rates used to convert feed prices, where they come from, and how often they refresh.
- [Languages and translation](https://help.monokaido.com/en/settings/languages): The catalogue's languages, the source language, and the automatic translation rules.
- [Payment history](https://help.monokaido.com/en/settings/payment-history): Your subscription and AI credit payments, invoices and receipts to download.
- [Changelog](https://help.monokaido.com/en/settings/changelog): What has been added and changed in the application — filtered by type, module and period.
- [Import logs](https://help.monokaido.com/en/settings/import-logs): How each import went: how many products were added, changed and failed — and why.
- [Glossary](https://help.monokaido.com/en/settings/glossary-terms): An explanatory list of the terms Monokaido uses — reachable from the footer of every screen.

## AI in Monokaido

- [AI in Monokaido](https://help.monokaido.com/en/ai): Everything the AI does in the system, what it costs, and where a person has the last word.
- [AI settings](https://help.monokaido.com/en/ai/settings): Monokaido AI versus your own key, monthly and permanent tokens, top-ups, and limits.
- [Brand voice](https://help.monokaido.com/en/ai/brand-voice): How the AI writes in your tone — instructions, examples, and which text types they apply to.
- [AI logs](https://help.monokaido.com/en/ai/logs): Every AI call: what was asked, what came back, what it cost, and whether it succeeded.
- [AI accuracy](https://help.monokaido.com/en/ai/accuracy): How often people correct the AI's output and what that says about your settings.

## Glossary

- [Glossary](https://help.monokaido.com/en/glossary): The terms this manual uses precisely — feed, variant, GTIN, link, merge and the rest.