Core Concepts
Key terms and concepts you'll encounter in Ploy.
Glossary
| Term | Description |
|---|---|
| Workspace | Your team's home base in Ploy. Contains your sites, documents, assets, brand design system, and integrations. Everything lives here. |
| Site | A website project inside your workspace. Each site has its own pages, components, and deploy history. You can have multiple sites in one workspace. |
| Ploy | A chat-based workflow where you collaborate with Korra to get things done — build a page, run research, write copy, analyze performance. Think of it as a mission-focused conversation. |
| Korra | Your AI assistant. She lives in the Ploy dashboard and can build pages, write content, design layouts, run SEO research, analyze analytics, generate images, and more. |
| Agent | AI workers that Korra coordinates behind the scenes. When a task is complex, Korra dispatches specialized agents to handle different parts in parallel — design, code, research, copywriting. |
| Deploy | A published snapshot of your site. Every time you publish, Ploy creates a new deploy. You can roll back to any previous deploy instantly. |
| Design System | Your brand's visual DNA — colors, fonts, spacing, border radius, and other tokens. Stored in your workspace and automatically applied to every page and component. |
| Brand | The combination of your design system, logo, and company information. Ploy can extract your brand from an existing website or Figma file, or you can configure it manually. |
| Assets | Images, logos, and files stored in your workspace. Includes user uploads, AI-generated images, Figma exports, and website screenshots. |
| Documents | Markdown files in your workspace for research, plans, briefs, and content drafts. Korra creates and edits these as part of her workflows. |
| Preview | A live, hot-reloading view of your site in the dashboard. Shows changes in real time as Korra works. |
| Publish | Push your site live. Deploys to Ploy's hosting infrastructure with automatic SSL. Add a custom domain whenever you're ready. |
| Custom Domain | Your own domain (e.g. yourdomain.com) pointed at your Ploy-hosted site. Ploy handles DNS verification and SSL certificate provisioning automatically. |
| Integrations | Connections to external tools — GitHub, Figma, Google Analytics, Google Search Console, Notion, Slack, HubSpot, and others. Configured in Settings. |
How They Fit Together
Workspace
├── Brand & Design System
├── Sites
│ ├── Pages & Components
│ ├── Deploys (publish history)
│ └── Custom Domain
├── Documents (research, plans, drafts)
├── Assets (images, logos, files)
├── Integrations (GitHub, Figma, GA4, etc.)
└── Ploys (chat workflows with Korra)Your workspace is the container for everything. Inside it, you create sites that are built from pages and components. Korra works with you through ploys — chat sessions where you describe what you need and she makes it happen, often dispatching agents for complex tasks. Your design system keeps everything visually consistent, and integrations connect Ploy to your existing tools.
What's Next?
- Get started — Follow the Quick Start guide to build your first site.
- Learn about Korra — Read the Korra guide for tips and capabilities.
- Explore the site builder — See how pages, components, and the design system work together.
