# Yedric Docs > Documentation for Yedric, AI assistants for any app or website. Every page is available as Markdown by appending `.md` to its URL. The full documentation is in one file at https://docs.yedric.ai/llms-full.txt. ## Welcome 👋🏻 - [Welcome 👋🏻](https://docs.yedric.ai/readme.md): Meet Yedric, the AI assistant that lives inside your product and answers user questions, with links to setup, developer and Shopify guides. ## Getting Started - [Getting Started](https://docs.yedric.ai/getting-started.md): Go from a new Yedric account to a working assistant in your app in 20 to 30 minutes: instructions, knowledge base content, and the live widget. - [Your Assistant](https://docs.yedric.ai/getting-started/your-assistant.md): Tour the tabs of a Yedric assistant to see where its knowledge, instructions, actions and widget appearance are each managed. - [Prompt](https://docs.yedric.ai/getting-started/prompt.md): Write the core instructions your Yedric assistant reads before every chat, covering what your app does, how it should respond, and what to avoid. - [Knowledge Base](https://docs.yedric.ai/getting-started/knowledge-base.md): Load the content your Yedric assistant learns from, so its answers are accurate and specific instead of relying on the system prompt alone. - [Page Prompts](https://docs.yedric.ai/getting-started/page-prompts.md): Use Yedric page prompts to show different suggested prompts, or even different instructions, depending on which page of your app a user is on. - [Widget](https://docs.yedric.ai/getting-started/widget.md): Customize how the Yedric widget looks and behaves in your app: colors, layout, greeting, and a live preview before you publish the changes. ## Going Further - [Going Further](https://docs.yedric.ai/going-further.md): Once your Yedric assistant is live, see which features help you monitor performance, improve your setup, and organize your team as usage grows. - [Dashboard](https://docs.yedric.ai/going-further/dashboard.md): Read the Yedric assistant dashboard to see how it is performing and which prompt edits, documentation gaps and opportunities to tackle next. - [Actions](https://docs.yedric.ai/going-further/actions.md): Let your Yedric assistant do things, not just answer, with built-in actions and custom actions that connect to your own app data and services. - [Settings](https://docs.yedric.ai/going-further/settings.md): Configure a single Yedric assistant's name, how the AI analyzer tags conversations, live chat and escalation setup, and assistant-level secrets. - [Usage](https://docs.yedric.ai/going-further/usage.md): Check token and efficiency numbers for one Yedric assistant to work out why usage changed or whether it is being used as you intended. - [Organizations](https://docs.yedric.ai/going-further/organizations.md): Understand Yedric organizations, the top-level structure that holds your assistants and users and controls access, structure and oversight. - [Conversations](https://docs.yedric.ai/going-further/conversations.md): Review every conversation users have with your Yedric assistant, from a chronological list to Trends reports on how people use your product. - [Live Chat](https://docs.yedric.ai/going-further/live-chat.md): Let visitors ask for a human in the Yedric widget and have your team reply from a dashboard inbox without a redirect or leaving your site. - [Alerts](https://docs.yedric.ai/going-further/alerts.md): Create Yedric alerts that appear on your site without the visitor opening the chat, to announce features, share guides or promote an offer. - [Build a Character](https://docs.yedric.ai/going-further/build-character.md): Generate a custom Yedric mascot with AI from a short description or your logo, pick one of eight styles, and get animated clips and avatars. - [Integrations](https://docs.yedric.ai/going-further/integrations.md): Connect Yedric to your team's other systems from Organization, pulling your own data beside a conversation or pushing events out to your app. - [Simulations](https://docs.yedric.ai/going-further/simulations.md): Test your Yedric assistant in a sandbox before going live: run sample messages, define a good response, and iterate on your configuration. - [Changes](https://docs.yedric.ai/going-further/versions.md): Browse the full history of changes to your Yedric assistant's configuration, see who changed what and when, and act on that history if needed. - [FAQ](https://docs.yedric.ai/going-further/faq.md): Answers to common Yedric questions about cost, trying it without your own API key, bringing Anthropic, OpenAI or Google keys, and scaling up. ## Shopify App - [Shopify App](https://docs.yedric.ai/shopify.md): Overview of Yedric for Shopify, an AI assistant that answers shoppers from your catalog and policies, looks up orders, and hands off to your team. - [Getting Started](https://docs.yedric.ai/shopify/getting-started.md): Install Yedric from the Shopify App Store and get a chat answering real shopper questions on your storefront in about five minutes. - [Going Deeper](https://docs.yedric.ai/shopify/going-deeper.md): Guide to each page of the Yedric app in your Shopify admin, in sidebar order, plus the other places Yedric appears across Shopify. - [Home](https://docs.yedric.ai/shopify/going-deeper/home.md): Use the Yedric Home page in Shopify for the setup guide, an at-a-glance view of your assistant, storefront chat status and 30-day numbers. - [Assistant](https://docs.yedric.ai/shopify/going-deeper/assistant.md): Set who answers in Shopify, what your Yedric assistant is called, how it sounds, and its always and never rules, with a live chat preview. - [Conversations](https://docs.yedric.ai/shopify/going-deeper/conversations.md): Search and read every chat, email and voice conversation your Yedric assistant has had in Shopify, then view summaries, add tags and team notes. - [Analytics](https://docs.yedric.ai/shopify/going-deeper/analytics.md): Read Yedric Analytics in Shopify to see how many shoppers chat, how they feel, what they ask about, resulting orders, and what to improve next. - [Settings](https://docs.yedric.ai/shopify/going-deeper/settings.md): Adjust how the Yedric chat looks and behaves on your storefront, the out-of-conversations message and your help page, with a live preview. - [Live chat and the inbox](https://docs.yedric.ai/shopify/going-deeper/team-inbox.md): Hand Yedric conversations to your team: take live chats in Chats and support emails or WhatsApp messages in the inbox, opened from Shopify. - [Plans and billing](https://docs.yedric.ai/shopify/going-deeper/plans.md): Compare the two Yedric for Shopify plans, billed on your Shopify bill, and find out how the store owner or an admin changes plans. - [Around your Shopify admin](https://docs.yedric.ai/shopify/going-deeper/around-shopify.md): Find where Yedric appears beyond the Apps list: storefront and customer account blocks, an admin block on orders and customers, and Sidekick. - [Capabilities](https://docs.yedric.ai/shopify/capabilities.md): See the extra things the Yedric assistant can do in Shopify, like order lookup, returns and size advice, and how to switch each one on. - [Custom replies](https://docs.yedric.ai/shopify/capabilities/custom-replies.md): Write your own answers for common shopper questions like shipping times or returns, so the Yedric assistant replies with exactly your wording. - [Order lookup](https://docs.yedric.ai/shopify/capabilities/order-lookup.md): Shoppers can ask the Yedric assistant where their order is and get its live status, items and shipments from Shopify, on every plan. - [Product availability](https://docs.yedric.ai/shopify/capabilities/product-availability.md): Have the Yedric assistant check live price and stock before answering, so shoppers never hear about items that sold out, on every plan. - [Discount codes](https://docs.yedric.ai/shopify/capabilities/discount-codes.md): Allow the Yedric assistant to offer single-use discount codes in situations you choose, with team approval by default before a code is sent. - [Order tracking](https://docs.yedric.ai/shopify/capabilities/order-tracking.md): Tell shoppers where their package is using Shopify tracking, plus Tracktor carrier updates when installed, and how they verify their order. - [Abandoned cart recovery](https://docs.yedric.ai/shopify/capabilities/abandoned-cart.md): Turn on Yedric abandoned cart recovery, a Pro plan capability that offers returning shoppers a link back to the checkout they left behind. - [Returns](https://docs.yedric.ai/shopify/capabilities/returns.md): Let shoppers start a return or swap sizes in chat within your Shopify policy, with optional refunds and, on Pro, emailed prepaid return labels. - [Order changes](https://docs.yedric.ai/shopify/capabilities/order-changes.md): Let shoppers change a shipping address, cancel an unshipped order or request item removal in chat, a Pro plan capability with rules you set. - [Size finder](https://docs.yedric.ai/shopify/capabilities/size-finder.md): Have the Yedric assistant recommend a size from your own size charts and select it on the product card, ready to add to cart, on the Pro plan. - [Product recommendations](https://docs.yedric.ai/shopify/capabilities/recommendations.md): Turn on Pro plan product recommendations so the Yedric assistant suggests products as cards with live price and stock, within a budget or collection. - [Voice](https://docs.yedric.ai/shopify/capabilities/voice.md): Give shoppers a store page where they talk to the Yedric assistant by voice and hear answers aloud, a Pro plan feature rolling out store by store. - [Automations (MESA)](https://docs.yedric.ai/shopify/capabilities/mesa.md): Let the Yedric assistant run MESA workflows, fill in MESA forms with shoppers, and start workflows from chat events like a request for your team. - [Tracktor](https://docs.yedric.ai/shopify/capabilities/tracktor.md): Use Tracktor carrier updates in Yedric order tracking when Shopify has no tracking link, covering over 2,000 carriers on a custom tracking page. - [Infinite Options](https://docs.yedric.ai/shopify/capabilities/infinite-options.md): See how Yedric works with the Infinite Options app so shoppers fill in engraving or gift message options in chat before adding to cart. - [Shopify Flow](https://docs.yedric.ai/shopify/capabilities/shopify-flow.md): Use the Yedric triggers and actions in Shopify Flow to start workflows from conversations, send replies, tag chats and flag unanswerable questions. - [Custom actions](https://docs.yedric.ai/shopify/capabilities/custom-actions.md): Connect your own API, MCP server or OpenAPI spec so the Yedric assistant can act in your systems, set up in the Yedric dashboard. - [Ask Yedric in POS](https://docs.yedric.ai/shopify/ask-yedric-in-pos.md): Let store staff ask your Yedric assistant about stock, orders, customers and return policy from Shopify POS, by typing or dictating on the register. ## Developers - [Developers](https://docs.yedric.ai/developers.md): Developer guide to the Yedric widget: embed it, secure sessions with HMAC, use the JavaScript API, and connect webhooks, custom apps and MCP. - [Embedding the Widget](https://docs.yedric.ai/developers/embedding-widget.md): Add the yedric-widget web component to any page with one script tag, using your agent ID, and review the attributes and common mistakes. - [Secure Mode](https://docs.yedric.ai/developers/secure-mode.md): Turn on Yedric secure mode to sign chat users with HMAC-SHA256 so sessions and history follow a verified identity across visits and devices. - [Advanced Configuration](https://docs.yedric.ai/developers/advanced-configuration.md): Find which Yedric widget settings live in the dashboard and which you set in code, plus advanced options for a working embed. - [JavaScript API](https://docs.yedric.ai/developers/javascript-api.md): Reference for the window.Yedric global and the yedric-widget element, including how to open the chat, send prompts, and use setConfig and getConfig. - [Client Events](https://docs.yedric.ai/developers/client-events.md): Report events from your app, like a finished test run or a failed job, to the Yedric assistant with Yedric.event so it can react or note them. - [MCP Server](https://docs.yedric.ai/developers/mcp-server.md): Connect Claude Desktop, Claude Code, Cursor or ChatGPT to the hosted Yedric MCP server to manage assistants and read conversation data. - [Webhooks](https://docs.yedric.ai/developers/webhooks.md): Send Yedric events to your own URL with signed webhooks, check signatures, understand automatic retries, and read the delivery log. - [Custom Apps](https://docs.yedric.ai/developers/custom-apps.md): Build a Yedric custom app that shows your own HTML in a panel beside each conversation, using the visitor context Yedric posts to your URL.