# Ploy Support Docs

> Ploy is an AI-powered web marketing automation platform that helps growth teams build, optimize, and publish high-converting marketing sites. These docs cover the platform, developer tools, setup guides, and troubleshooting.

Ploy includes an in-app AI agent that can build pages, write copy, run research, analyze performance, generate images, operate integrations, and manage deploys through natural conversation. The Ploy CLI provides a standalone terminal interface for workspace, site, content, publishing, and local-development workflows.

## Getting Started

- [Introduction](https://docs.ploy.ai/introduction): What Ploy is, why it exists, and how the platform building blocks fit together.
- [Quick Start](https://docs.ploy.ai/quick-start): Start with a goal, review a focused route, and work with Ploy to complete it.
- [Core Concepts](https://docs.ploy.ai/core-concepts): Key Ploy terms including workspaces, sites, Ploys, Ploybooks, deploys, and the design system.
- [Ploy for Agencies](https://docs.ploy.ai/agencies): How agencies set up Ploy for multiple clients: keep billing on one plan with a workspace per client, or give each client their own organization so they pay for their own site.
- [Tips & Tricks](https://docs.ploy.ai/tips-and-tricks): Thirteen field-tested habits for getting fast, on-brand results with Ploy: writing a complete brief, sharing screenshots, one change per chat, choosing Ploy Agent or Ploy Lite, checking credit usage before a full build, publishing and rolling back, connecting integrations, and automating reporting, plus two publishing and DNS gotchas.
- [Working with a Team](https://docs.ploy.ai/working-with-a-team): Invite collaborators, assign Owner, Admin, or Member roles, and limit Members to specific workspaces in Ploy.

## Platform

- [Ploy's Agent](https://docs.ploy.ai/ploy-chat): What Ploy’s in-app agent can do and how to work with it effectively.
- [Projects](https://docs.ploy.ai/projects): Group the chats, pages, and Ploybooks for one goal, track it on a live dashboard, and get a daily check-in.
- [Site Builder: build on-brand landing pages and websites with AI](https://docs.ploy.ai/site-builder): Ploy's Agent builds landing pages from a chat on Astro, React and Tailwind, using a design system made from your site or Figma file. Keep drafts private until you publish.
- [Ploy Effects](https://docs.ploy.ai/effects): Add Paper Shaders WebGL backgrounds, image filters, and logo animations tuned to your design tokens. Rolling out per workspace.
- [Assets](https://docs.ploy.ai/assets): Find, upload, preview, and reuse workspace images, videos, fonts, and documents in Library Assets.
- [Migrate from Framer to Ploy and keep the code](https://docs.ploy.ai/migrate/framer): Move a published Framer site to Ploy in five steps: import the pages, import the CMS, rebuild what does not transfer, keep the code with Git or GitHub, and switch traffic without losing URLs.
- [Migrate CMS Content to PloyDB](https://docs.ploy.ai/database/cms-migration): Analyze supported CMS sources, import structured content into PloyDB, and build new pages from the imported tables.
- [Analytics: first-party website analytics built into Ploy](https://docs.ploy.ai/analytics): Every published Ploy site tracks pageviews, sources, AI-assistant visits, clicks and forms with first-party analytics. Build dashboards in a chat and connect GA4 and Search Console.
- [AI search visibility: monitor and improve it with Ploy](https://docs.ploy.ai/ai-search-visibility): Check how ChatGPT, Gemini, Claude, Perplexity and Google AI answer your customers' questions, then make your site easy for AI tools to read, cite and act on.
- [Publishing & Deploys](https://docs.ploy.ai/publishing): Publish a site, manage deploys, roll back, and connect a custom domain.
- [Ploy AI Gateway](https://docs.ploy.ai/ai-gateway): Use AI models from OpenAI, Anthropic, ElevenLabs and other providers on your website and in Ploy's Agent's work, with no API keys. Calls use your Ploy credits.
- [Audience](https://docs.ploy.ai/audience): Know who your audience is and reach them. Ploy's audience tooling combines Contact Tools for finding and enriching people and companies with Visitor Identification for seeing who's already visiting your site.
- [CMS & Blogging](https://docs.ploy.ai/cms): Run a blog and manage content on your Ploy site with a built-in database, native file content, or an external CMS.
- [Contact Tools](https://docs.ploy.ai/contact-tools): Find, enrich, and discover people and companies right from chat. Email and phone lookup, email verification, people and company enrichment, and structured prospect discovery — built into Ploy, no data provider to connect.
- [Database](https://docs.ploy.ai/database): Store structured content in a built-in database you can edit like a spreadsheet and use across your site, automations, and Ploy's Agent.
- [Use PloyDB from your own app](https://docs.ploy.ai/database/external-apps): Read and write PloyDB from an external backend, serverless function, mobile app, or other non-browser client.
- [Docs](https://docs.ploy.ai/documents): Find the documents you and Ploy's Agent create.
- [Environment Variables & Secrets](https://docs.ploy.ai/environment-variables): Store configuration and credentials for your published Ploy site. Variables vs. secrets, .env bulk import, Preview vs. Production scoping, and how changes apply on publish.
- [Experiments: A/B test a landing page section](https://docs.ploy.ai/experiments): A/B test one section of a marketing page in Ploy. Pick a goal event, have Ploy's Agent draft the challenger, split traffic between 10% and 90%, and publish the winner.
- [Form Submissions](https://docs.ploy.ai/form-submissions): View website form submissions and configure email notifications for new submissions.
- [Launch Checklist](https://docs.ploy.ai/hosting/launch-checklist): Everything to verify before you publish your Ploy site — content, SEO, analytics, domain, and final QA.
- [Migration Readiness Checklist](https://docs.ploy.ai/hosting/migration-readiness): What to check in the days before you move an existing site to Ploy: sitemap and redirects, links, URL patterns, robots.txt, DNS and SSL, and image alt text.
- [Ploy Lite — Guidance for Focused Work](https://docs.ploy.ai/ploy-lite): Learn when to choose Ploy Lite for straightforward, focused work and when to ask for Ploy Agent.
- [Ploybooks](https://docs.ploy.ai/ploybooks): Save a workflow once and run it again — on demand, on a schedule, or on a webhook trigger. Learn what Ploybooks are, when to use them, how to create one from a Ploy conversation, and how to schedule them.
- [Allow Trusted Iframe Embedding with CSP](https://docs.ploy.ai/publishing/content-security-policy): Prompt Ploy to configure an Astro site on a custom domain with a Content-Security-Policy frame-ancestors header and no conflicting X-Frame-Options.
- [Visitor Identification: see the companies and people visiting your website](https://docs.ploy.ai/visitor-identification): See which companies and people visit your Ploy site, with name, company, job title, LinkedIn, visit count and pages viewed. Uses visitor-enrichment credits on Starter and Pro.
- [Personalize by Visitor Location](https://docs.ploy.ai/visitor-location): Show different content to visitors based on their country, state or city, using the location headers Ploy passes to your site on each visit.

## Ploy CLI

- [Ploy CLI](https://docs.ploy.ai/cli): Use the standalone CLI interactively, from automations, or through AI agents to manage sites, domains, routing, publishing, PloyDB, content, Ploybooks, Code Sync, and design-system context.
- [CLI Installation & Updates](https://docs.ploy.ai/cli/install): Install the macOS or Linux binary, manage updates and PATH, and control installer analytics.
- [CLI Authentication & Tokens](https://docs.ploy.ai/cli/authentication): Sign in through Ploy or use a workspace-scoped API token for CI and other headless environments.
- [CLI Sites, Domains, Routing & Publishing](https://docs.ploy.ai/cli/workspaces-sites): Select workspace and site context, manage custom domains and routing documents, publish production, and run Code Sync.
- [CLI Workspace Transfers](https://docs.ploy.ai/cli/workspace-transfers): Copy a Ploy site and its dependencies between workspaces, verify the destination, move traffic, and clean up safely.
- [CLI Variables & Secrets](https://docs.ploy.ai/cli/variables-secrets): Manage preview and production Variables, encrypted Secrets, and atomic dotenv imports.
- [PloyDB CLI Commands](https://docs.ploy.ai/cli/database): Manage PloyDB databases, tables, columns, and rows; monitor duplication operations; and import typed CSV data.
- [CLI Documents & Ploybooks](https://docs.ploy.ai/cli/documents-ploybooks): Read and write workspace Markdown, manage Ploybooks, apply exact edits, and configure schedules.
- [CLI Agent Skills & Site Inspection](https://docs.ploy.ai/cli/local-development): Equip agents with Ploy skills and inspect components, pages, theme colors, and page-build plans in a checked-out site.
- [CLI Remote Agents & CI](https://docs.ploy.ai/cli/remote-development): Run the Ploy CLI from remote coding agents and CI with API tokens, explicit IDs, safe secret handling, and non-interactive commands.
- [CLI Command Reference](https://docs.ploy.ai/cli/reference): Global syntax, options, environment variables, saved state, exit codes, automation support, and command index.
- [Bring Your Own Astro Repository to Ploy](https://docs.ploy.ai/cli/bring-your-own-repo): Repository, dependency, Astro config, Cloudflare Workers, prerendering, Code Sync, and publishing requirements for migrating an existing Astro site to Ploy.
- [CLI Chats](https://docs.ploy.ai/cli/chats): Start and continue chats with Ploy's Agent from the terminal.

## Hosting

- [Advanced Custom Domain Setup](https://docs.ploy.ai/custom-domains/advanced-setup): Cut over traffic from your pre-existing web host to Ploy without downtime through a staged, manual rollout.
- [Advanced DNS Setup Checklist](https://docs.ploy.ai/custom-domains/advanced-setup/checklist): A checkable checklist for cutting over traffic from your pre-existing web host to Ploy without downtime.
- [Serve Ploy Behind Your Own Proxy](https://docs.ploy.ai/custom-domains/behind-your-own-proxy): Keep your own proxy, such as a Cloudflare Worker, Vercel rewrites or Nginx, in front of your domain and serve some paths from your Ploy site.
- [Buy a domain in Ploy](https://docs.ploy.ai/custom-domains/buy-domain)
- [DNS Setup Reference](https://docs.ploy.ai/custom-domains/dns-setup): Generate the exact DNS records you need to add at your registrar to connect your domain to Ploy.
- [How Ploy Works With Your Domain](https://docs.ploy.ai/custom-domains/domain-visualizer): Enter your domain to visualize how traffic routes through Ploy — what Ploy serves directly and what falls back to your existing site.
- [Proxy to Origins](https://docs.ploy.ai/custom-domains/proxy-to-origins): Forward traffic from your Ploy-hosted custom domain to an upstream origin like Vercel, Webflow, or Google Cloud Run.
- [Framer — Fallback Origins](https://docs.ploy.ai/custom-domains/proxy-to-origins/framer): Point Ploy at your Framer project's stable *.framer.website subdomain and proxy unmatched traffic to it during your site migration.
- [Lovable — Fallback Origins](https://docs.ploy.ai/custom-domains/proxy-to-origins/lovable): Point Ploy at your Lovable project's origin URL and proxy unmatched traffic to it during your site migration.
- [Webflow — Fallback Origins](https://docs.ploy.ai/custom-domains/proxy-to-origins/webflow): Set up a wf-origin subdomain on Webflow and proxy unmatched Ploy traffic to it during your site migration.
- [Ploy Connect WordPress Plugin](https://docs.ploy.ai/hosting/ploy-connect-wordpress-plugin): Serve Ploy-hosted landing pages and marketing content from your WordPress domain using the Ploy Connect reverse proxy plugin.
- [Website Migration Cost Calculator](https://docs.ploy.ai/migration-cost-calculator): Use Ploy's free website migration cost calculator to scan your current site, understand the factors behind a manual migration estimate, and plan your move to Ploy.

## Account & Billing

- [Credits](https://docs.ploy.ai/credits): Understand plan allowances, personal wallets, referral rewards, balance tracking, and billing-cycle resets.
- [Notifications](https://docs.ploy.ai/notifications): Know when a chat finishes or needs your answer.

## Integrations & Trust

- [Integrations](https://docs.ploy.ai/integrations): Connect GitHub, Figma, Google Analytics, Search Console, Notion, Slack, HubSpot, and more.
- [Security & Compliance](https://docs.ploy.ai/security): How Ploy protects your data, sites, and visitors.
- [Advanced Security Controls](https://docs.ploy.ai/enhanced-security): Advanced options for Ploy accounts and organizations, including passkeys and SSO.
- [Webhooks](https://docs.ploy.ai/webhooks): Send events from external systems into a workspace and trigger Ploybooks.
- [Account Security](https://docs.ploy.ai/enhanced-security/account): Protect your Ploy account with passkeys — a phishing-resistant alternative to passwords.
- [Organization Security](https://docs.ploy.ai/enhanced-security/organization): Require enhanced sign-in for your organization's owners, admins, or all members.
- [Ploy Code Sync](https://docs.ploy.ai/integrations/code-sync-github): Connect a GitHub repository to your Ploy Site. Ploy's Agent commits changes to the ployspace repo; your team's pushes flow back into the sandbox.
- [Ploy MCP](https://docs.ploy.ai/mcp): Connect Ploy to Claude Desktop, Claude Code, ChatGPT, Codex, Grok, Grok Bot, Muse, Cursor, and other AI tools with the Ploy MCP server.
- [Single sign-on (SSO)](https://docs.ploy.ai/security/sso): Set up single sign-on (SSO) via OpenID Connect (OIDC), configure your identity provider, verify your email domain, and test sign-in.
- [Ploy in Slack](https://docs.ploy.ai/slack): Connect Slack, link your Ploy account, and chat with Ploy's Agent in Slack DMs and threads.

## Support

- [Custom Domain Setup](https://docs.ploy.ai/custom-domains): Connect an apex domain or subdomain with automatic or manual DNS setup.
- [Reverse Proxy & Routing Rules](https://docs.ploy.ai/routing-rules): Route paths to Ploy pages or external origins and serve Ploy alongside an existing site.
- [FAQ & Troubleshooting](https://docs.ploy.ai/faq): Common Ploy issues and how to resolve them.

## Search

- [Site search API](https://ploy.ai/agent-tools/search?q=how+do+I+connect+a+custom+domain): GET https://ploy.ai/agent-tools/search?q=your+question searches docs.ploy.ai and ploy.ai by meaning and returns the 5 best matching sections as JSON. Fetch any result URL with Accept: text/markdown for the full page. Also available in the browser as the WebMCP tool search_ploy.

## Contact

- General support: support@ploy.ai
- Website: https://ploy.ai