Skip to main content

​
Getting Started

Macaly is designed for building marketing websites, landing pages, portfolios, blogs, web apps (contact forms, booking pages, record-keeping systems), simple 3D apps and games, visuals, and prototypes or MVPs. It excels at professionally designed, fast-loading sites.
Macaly is not the right tool for complex enterprise applications, native iOS or Android mobile apps, desktop software, or projects requiring PHP, Python backends, WordPress, or Supabase. It works exclusively with Next.js (React) and Convex as its database.
Yes, Macaly works fully in any language. Simply give the agent instructions in your preferred language (Czech, French, German, Spanish, etc.) and it will generate the project content in that language. If you need multilingual pages, describe clearly which sections should appear in which language.
Yes. Macaly can set up authentication using OTP (one-time password sent by email) or a standard email and password login system. Just describe what you need and the agent will implement it.
Yes. Visual edits lets you click directly on text, images, and other elements in the preview and change them without sending a message to the agent. Those changes are written into your project when you save and use no credits. The exception is Rewrite with AI and Generate with AI, which do use credits and show the price before you run them.
Macaly works great in a mobile browser, so you can create and manage your projects right from your phone. The one exception is Visual edits, which is available only on larger-screen devices.

​
Pricing update: October 2026

On 8 October 2026, Macaly introduced the Starter plan ($10/month) and set clear limits on the Free plan: published apps, file storage, a website traffic allowance, and 100 Cloud actions per month. The Hosting plan is no longer offered to new customers. The Pro plan is unchanged. See Plans and credits for what each plan includes.
Starter costs $10/month (€8.80 or 210 Kč, depending on your billing currency) and is billed monthly only. It is meant for publishing one app on your own custom domain without the Macaly badge. It includes:
  • 1M credits per month
  • 1 published app on your own custom domain (the domain purchase is charged separately)
  • 5 GiB of file storage
  • 5 GiB of database usage
  • A 5 GB website traffic allowance
  • No monthly Cloud action limit
  • Email support and 3 months of analytics retention
Starter does not include the GitHub integration. If you need more credits or more room, choose Pro.
Nothing changes. You keep your Hosting plan, its price, and its features. You can still manage or cancel it from Billing.
No. Hosting is no longer offered to new customers. To keep a site live on your own domain, choose Starter.
Free includes 1 published app. If you have more, we email the workspace owners and admins first and give you time to choose which one stays live (the email tells you the exact date). You can also upgrade to a plan that includes more published apps. After the deadline, the other apps are unpublished. Your projects and data stay, and you can publish them again after upgrading, or once you’re within your plan’s limit. Unpublished apps are also removed from the community showcase.Until then, publishing a new app needs a free slot. To free one, unpublish an app. The slot becomes available again within a few minutes. Drafts and previews do not count toward the limit. See Published apps over the limit.
Cloud actions are what external AI agents, such as ChatGPT, Claude, or other MCP clients, do through Macaly Cloud. These count:
  • Creating or duplicating an app
  • Writing, editing, or deleting files
  • Running commands
  • Uploading files
  • Publishing
  • Connecting a domain
Reading files, listing, and previews are free. Chatting with Macaly inside the app does not use Cloud actions.
The Free plan includes 100 Cloud actions per month. Paid plans have no monthly Cloud action limit. The Free allowance is shared by the whole workspace and resets on the 1st of each month (UTC). Unused Cloud actions do not roll over.
Further counted actions are refused. The message shows the date when the allowance resets and a link to Billing. Reading files, apps that are already live, and chatting with Macaly inside the app keep working.
Yes. Downgrades take effect at the end of the current billing period. In Billing, schedule the switch to Starter, or choose Starter when you cancel Pro. Pro and its credits stay until the renewal date.At renewal, Macaly checks the workspace. If it has more than 1 published app or more than 5 GiB of files, the switch is cancelled and Pro renews. This check never unpublishes or deletes anything. You can undo a scheduled switch with Keep Pro.
Open Billing and choose the plan. Upgrades take effect immediately: you pay the full price of the new plan, receive its full credits, and your billing period restarts.
New uploads, and copying a database, are refused until you free up space. Existing files stay readable and published apps stay online.
Not today. The traffic figure on each plan is an allowance only. It is not metered, enforced, or charged.
Billing and Settings → Usage & limits (see Usage & limits) show your Cloud actions (Free plan), published apps, file storage, and the traffic allowance.
On the Free and Starter plans, a bar at the top of the home screen and inside chats warns you when your workspace is close to or over a plan limit. It turns amber at 80% and red when a limit is reached or exceeded (published apps turn red only when you have more live apps than your plan includes). It only informs: it can’t be dismissed, and it doesn’t unpublish anything by itself. See Plan limit warnings.
New Free workspaces receive 1 million credits per month. Otherwise, credits and top-ups work as before.
Starter includes 5 GiB of database usage per month and Pro includes 10 GiB. On Starter, Pro, and Agency, each additional started 1 GiB used within a calendar month costs 200K credits. If you upgrade from Free or Hosting mid-month, your paid allowance starts at the upgrade and usage from before it is never charged. See Plans and credits for the full table.

​
Plans and credits

Credits are consumed each time you send a prompt to the Macaly agent. The amount depends on the complexity of the task. Free plan users receive 1 million credits per month. Paid plan credits are valid for 30 days. Users on a paid plan (Starter or Pro) can also purchase one-time credit top-ups, which are valid for 60 days.
No. Each billing period starts with a fresh set of credits and any unused credits expire at the end of the period. You can purchase one-time credit top-ups, which are valid for 60 days from the date of purchase.
Yes. If you are on a paid plan (Starter or Pro), you can purchase a one-time credit top-up at macaly.com/billing. Top-up credits are valid for 60 days, which is longer than the standard 30-day billing period. If you are on the Free plan and need more credits, you will need to upgrade to a paid plan first.
Yes. Upgrades take effect immediately: you are charged the full amount, receive the full credits, and your billing cycle resets. There may be a short processing delay before your credit balance updates — a page refresh usually resolves this. Your unused credits from the previous tier remain available until the end of the current period. Downgrades, including switching from Pro to Starter or to the Free plan, take effect at the end of your current billing period.
If you are on Starter, you can either purchase a one-time credit top-up or upgrade to Pro. If you are on Pro, you can either purchase a one-time credit top-up or upgrade to a higher plan. If you are on the Free plan, you will need to upgrade to continue using the agent. All your projects remain active and your work is not affected.
Free plan users receive 1 million credits per monthly billing cycle. If your balance shows 0 and you have not used any credits, contact support. They can investigate your account. Paid plan credits are added at the start of each 30-day billing cycle.
It depends on the situation. If a confirmed platform-level issue occurred (such as the agent getting stuck, a sandbox crash, or a service outage), contact support with the link to the affected chat and the team will review the case and return credits as appropriate.If the agent was responding normally but needed multiple attempts to fix something, this is expected behavior with AI agents. To get the best results and avoid unnecessary credit use, provide the agent with as much context as possible, including screenshots and clear descriptions, rather than sending repeated fix commands. If the agent cannot resolve an issue even with full context provided, contact support and the team will investigate on a case-by-case basis.
If you are making your first purchase, you can enter a promo code during checkout on the billing page. If you already have an active paid plan, promo codes cannot be entered directly. Contact support with your code and the team will apply the discount to your account manually.
With the pricing update, all old Pro, Plus, and Ultra plans now include the same features as the current Pro plan. Your remaining messages have been converted at a rate of 1 message = 100,000 credits. You can continue using your current plan until it ends, but you can only switch to one of the new plans going forward.

​
Billing & Subscriptions

Go to macaly.com/billing, click Manage on your current plan, then select Cancel subscription. After cancellation, your access continues until the end of the current billing period. Free includes 1 published app. If you have more, we email you first and give you time to choose which one stays. The others are unpublished; your projects and data stay and you can publish them again after upgrading, or once you’re within your plan’s limit.
Macaly supports billing in USD, EUR, and CZK. Use the currency selector in the top-right of the Billing page to choose. Your selection sets the currency you are actually charged in, not just how prices are displayed.
You can change your billing currency freely before you start a subscription. If you already have an active subscription, contact support and the team will change it for you.
Go to macaly.com/billing and click the Invoices tab. All past invoices are listed there and can be downloaded individually.
When you upgrade your plan, you are charged the full price of the new tier immediately, not just the difference. For example, upgrading from $25/month to $50/month charges $50 right away. If you believe a charge was made in error, contact support. They can process a refund if credits from the upgraded tier have not yet been used.
Contact support as soon as possible. Refunds for accidental renewals are handled case by case. If you have not yet used the renewed credits, refunds are typically possible. Macaly’s refund policy is outlined in Section 7 of the Terms of Service at macaly.com/terms-of-service.
Yes. The Starter plan ($10/month, billed monthly) includes 1 published app on your own custom domain, no Macaly badge, and 1M credits per month. The domain purchase is charged separately. Starter does not include the GitHub integration.To switch from Pro to Starter, schedule the switch in Billing, or choose Starter when you cancel Pro. Pro and its credits stay until the renewal date. At renewal, Macaly checks the workspace. If it has more than 1 published app or more than 5 GiB of files, the switch is cancelled and Pro renews. This check never unpublishes or deletes anything. You can undo a scheduled switch with Keep Pro.
No. Hosting is no longer offered to new customers. If you are already on Hosting, you keep your plan, price, and features, and you can still manage or cancel it from Billing.
If you cancel Pro and return to the Free plan, your custom domain reverts to the default Macaly URL and the Made with Macaly badge reappears. To keep both, switch to the Starter plan ($10/month) instead. Schedule it in Billing, or choose Starter when cancelling your Pro plan.

​
Publishing & Deployment

Click the Publish button in the top-right corner of the editor. After publishing, your site is live at a free Macaly subdomain (e.g. myproject.macaly.app). To connect a custom domain, go to Settings → Domains. A custom domain requires a Starter, Pro, or Agency plan, or an existing Hosting plan.
Open the Publish dialog. If it shows Can’t check publish state, click Try again. Macaly checks again without starting a new build. If it stays stuck, contact support with your project link.
The preview URL and the published URL (your Macaly subdomain or custom domain) are separate environments. You need to click Publish to push your changes to the live site. If the live site still does not update, open the Publish dialog again. If it shows Publishing failed, click Fix it now to let the agent repair the error, or publish again. If that doesn’t help, contact support with your project link.
Yes. Go to Settings in your project and use the export option to download a ZIP of your source code. This feature requires at minimum the lowest-tier Pro plan and is not available on the Free plan.
It is the visible notice that your site was built with AI. It cannot be turned off on the Free plan; Starter, Pro, Agency, and existing Hosting plans can hide it in Settings → General. Published sites also carry a machine-readable ai-generated tag. See Using AI responsibly.
Macaly discloses that the platform is AI-powered, and the badge on your published site shows how it was built. Whether you need to disclose anything further about your content or your own AI features depends on applicable law and the specific use case. Using AI responsibly walks through the common cases.
No. The notice you see in Macaly applies to Macaly. If your project has a chatbot or any other AI feature, telling your end users about it is part of your application. Ask the agent to add a notice above the chat input or at the start of the conversation.

​
Domains & Hosting

In your project, go to Settings → Domains, type your domain name, and click Connect. Macaly will show the DNS records you need to add. Go to your domain registrar and add the A record and CNAME record as shown. After saving the records, return to Macaly and click Refresh. Connecting a custom domain requires a Starter, Pro, or Agency plan, or an existing Hosting plan.
You typically need two records:
  • An A record for the root domain pointing to Macaly’s IP address
  • A CNAME record for www pointing to Macaly’s hostname
The exact values are shown in Settings → Domains when you add your domain.
Add an A record for the bare/apex domain pointing to Macaly’s IP address (216.150.1.1). Remove any existing conflicting A or AAAA records for the root domain. If the bare domain shows SSL certificate missing in Settings → Domains even though its records are correct, click Retry SSL certificate. You can retry once an hour. Contact support if you are unsure which records to remove.
Double-check that the DNS records at your registrar exactly match what Macaly shows. Remove any conflicting records. Click Refresh in the Macaly Domains panel. DNS propagation can take up to 24 hours.
No. The Hosting plan is no longer offered to new customers. To use a custom domain, choose the Starter plan ($10/month) or Pro. If you are already on Hosting, you keep your plan, price, and features, and you can still manage or cancel it from Billing.
Macaly does not provide email hosting. For email on your custom domain (e.g. info@yoursite.com), sign up with a third-party provider such as Google Workspace, Zoho, or Microsoft 365, and configure their MX records with your registrar. Once you have an email address, the Macaly agent can set up contact forms to send notifications to it.

​
Email & Notifications

Yes. Macaly has a built-in email API powered by Resend. By default, outgoing emails are sent from noreply@email.macaly-app.com. To send from your own domain address, you need your own Resend account and API key. Ask the agent to set up email functionality and provide your desired sender and recipient address.
The default limit is a maximum of 10 emails per minute per application. Macaly can only send emails, not receive them. It is not suitable for newsletters or bulk marketing emails.
First, check your spam or junk folder. If emails are truly not arriving, contact support with the link to your project and the email address involved. The team can investigate email delivery on the backend.

​
Working with the Agent

If the agent shows no progress for more than 10 to 15 minutes, reload the page. If the preview is frozen, try Rebuild Preview or Restart App in its toolbar. If the last change broke your project, use Version history or Restore this version. If the problem persists, contact support with the chat link and approximate time. Credits consumed during a confirmed stuck session will be reviewed.
When reporting an error, be as specific as possible. Describe what you were doing before the error, what you see now, what is not working, and what the correct behavior should be. The more detail you provide, the better the agent can fix it on the first try.
Macaly has approximately 20 steps per user request. If your prompt is too complex, the agent may not complete everything. Break large requests into smaller sequential steps: send one specific change per message, verify it works, then move on.
Macaly saves project versions so you can restore earlier code. For your own copies, use GitHub for code if your plan supports it, and Export in the Database tab for table data. The ZIP does not include files uploaded to your app. A duplicate copies the current project, not an earlier database state.
Yes. Click the clock icon in the top bar to open Version history, pick a version to preview it, and click Restore. You can also use the Restore this version button under any agent response. Either way, the project code goes back to the state it was in at that point. See Version history. This restores code only, not database data or files uploaded to your app. Publish again to update your live site.

​
AI models

Yes. Macaly runs on several models from different companies, and you can pick which one the agent uses. GLM 5.3 Flash is the default. It is fast and cheap on credits, and works well for most everyday changes. See AI models for the full list and what each one suits.
You can change the model in two places. To change it for all your chats, open Settings, go to the Preferences tab, and pick a model under AI. To pick a model for one specific project, open that chat, go to the Settings tab, and pick a model under AI Model. The setting in a project always takes precedence over the setting in your account.
Stay on the default unless you have a reason to change. Move up to a model built for complex work when you are adding something like user accounts, payments, or more complex logic. Drop to a faster, cheaper one for text edits and small tweaks. See AI models for the current options.
Each company builds its models differently, and the differences show up more in style than in what the model can do. Which one suits you often comes down to the project and to personal preference, so it is worth trying a few.
Yes. Credit use depends on the selected model’s rates and the tokens it processes and generates. The size of the change and the length of the conversation also play a part. See Plans and credits for how credits work and what each plan includes.
Every model is marked EU, US, or Global. Global routing can process requests in different regions, including outside the EU. If your project handles personal data and you need that data to stay in the EU, pick a model marked EU.
Yes. Your choice applies to your next message. Everything the agent has already built stays as it is, and it keeps the full history of your project, so you can switch models at any point without losing anything.
Projects you started a while ago may still be set to a model that has since been retired. Those projects keep working. They now run on the newer version of the same model, so you get the improvements without doing anything. New chats always use the current lineup.

​
Technical Issues & Errors

Error 524 is a timeout, meaning the server did not respond in time. Try refreshing the page after a minute or two. If it persists, contact support with your chat link. You can check for ongoing incidents at status.macaly.com.
The sandbox server crashed. It should restart automatically within one to two minutes. If it does not, contact support with your chat link. The team can restart the sandbox and refund any credits consumed during the outage.
If you see it in the Macaly editor, reload the page. If it keeps happening, contact support with your chat link. If the error appears on your published site, report it to the agent with a clear description or contact support.
Single images must not exceed 8000×8000 pixels. If uploading more than 20 images in one request, each must be under 2000×2000 pixels. Files should be under 5 MB. If you encounter an SVG upload error, contact support.

​
Duplicating Projects

Open the chat menu and select Duplicate. A normal duplicate copies the current project without its conversation history and gets a separate database. Current table data is copied where supported; older projects with legacy App Files may start with an empty database and no uploaded files. Publish the copy and reconnect its custom domain if needed. Use Version history to recover an earlier code version.
No. Each duplicate gets its own separate database.
Yes. Click Share next to the Publish button and set the visibility to Anyone with the link. Share the link. Anyone who opens it can view the project and duplicate it into their own Macaly account.
Yes. Any project can be duplicated and shared with your client. They can then continue developing and managing the site in their own Macaly account, independently from you.

​
Databases

No. Every Macaly project gets one automatically. You don’t need to set one up with a provider, enter credentials, or connect anything. Describe what you want to store, such as contact form submissions or blog posts, and the agent creates the tables and wires them into your project.
Macaly uses Convex. Every project has its own isolated database with real-time updates and automatic scaling, hosted in the EU. See Databases.
The database is included in every plan, and staying within your monthly usage allowance costs no credits. On the Starter, Pro, and Agency plans, usage above the allowance is charged in credits. On Starter, Pro, and Agency, each additional started 1GiB costs 200K credits. On Starter, Pro, and Agency, each additional 100,000 backend API calls costs 200K credits. The allowance is counted across your whole workspace and resets at the start of each calendar month. If you upgrade from the Free or Hosting plan mid-month, the paid allowance starts at the upgrade and earlier usage is never charged. You’ll find the details in Plans and credits.
The Database tab lists your tables and shows the rows in each one. You can filter and sort them, edit values right there, add rows, or delete them. Creating tables and changing which fields they have happens in your project’s code, so ask the agent for those, for example: “Add a phone field to the Leads table.”
Yes. In the Database tab, click Add testing mode and Macaly creates a Testing database, a separate copy of your data that you can work in without changing what your users see. You can switch between your Live and Testing databases whenever you want, and publish from either one. Publishing from Testing runs a compatibility check first so your published app keeps working with its existing data.
Export in the Database tab downloads a ZIP snapshot of your table data, and Import restores one. Files your project stores, such as uploaded images, are not part of that file. Keep a snapshot before bigger changes, since deleting rows and importing a snapshot both replace data permanently.

​
SEO

Macaly builds search-engine-friendly sites. Server-side rendering, clean HTML, and meta tags are all handled by Macaly for you. Once you publish your project, the SEO audit scores your site and tells you what to improve. You can also edit meta tags, page titles, and descriptions in Settings → SEO.
The audit in the SEO tab checks your published site, so it stays locked until you publish. If you want a score before that, ask the agent in chat to run an SEO audit and it checks a preview of your current edits instead.
The audit reflects your last published version. If you’ve changed something since then, publish your project again and the audit results will refresh. You can also ask the agent to audit your unpublished changes on a preview.
AI readiness measures how well AI crawlers, such as those from ChatGPT, Claude, or Perplexity, can reach your site and understand it. It checks that your content is on the page itself rather than loaded with JavaScript, that AI crawlers aren’t blocked, and that an llms.txt file is available to guide them. Macaly renders your pages on the server automatically.
Work through the list of issues, errors first, then warnings. Either use the Fix all with AI button and hand the agent every issue at once, or work through them one by one. Then publish your changes and the score updates on the next audit.
Google indexing takes a while, often days to weeks. To speed it up, submit your site URL to Google Search Console at search.google.com/search-console. You can also share your URL on social media, since Google crawls links it finds elsewhere on the web.
Technically yes, using your published Macaly URL in an iframe. However, content inside iframes is poorly indexed by search engines, which has a negative impact on your SEO. A better approach is to use Macaly as a standalone site with its own custom domain.

​
Accounts

Your account is your personal identity — your email, sign-in, and personal preferences like theme and language. A workspace is where the actual work happens, with its own projects, credits, members, and billing. One account can be in multiple workspaces, which is useful for separating personal projects from client work or for collaborating with different teams.
Settings under Personal follow your account everywhere. Your theme, language, AI model preference, and notifications stay the same in every workspace. Settings under Workspace are tied to each workspace, so members, domains, API keys, and connections are different in each one.
Contact support and provide the new email address. They will update it on the backend. Note: you cannot use an email address that is already registered to another Macaly account.
Check your spam or junk folder first. If the email is not arriving at all, contact support. They can verify your account status and help with authentication.
Open Settings → Security. You’ll see all devices currently signed into your account, with the option to sign out remotely. This is useful if you’ve used Macaly on a shared computer or lost a device.
Contact support and request account deletion. They will delete your account and all associated data. Note: this action is irreversible. All projects, credits, and data will be permanently removed.

​
Workspaces

No. Each workspace has its own plan and its own credits. If you’re in multiple workspaces, each one tracks credits and billing independently. Switching to another workspace switches to its credit balance.
No. The 1M monthly free credits apply only to your default workspace — the one created when you first signed up. Any additional workspaces you create start on the Free plan but without credits, so you’ll need to upgrade them to a paid plan to use the agent.
Everything in that workspace is permanently deleted: projects, chats, databases, and any connected custom domains. This cannot be undone, so back up or duplicate anything you want to keep before deleting.
No. Each workspace has exactly one Owner who manages billing, admin, and members. Everyone else is a Member with full access to chats and credits, but without admin rights.
Workspace ownership cannot currently be transferred through the interface. If you need to change the Owner of a workspace, contact support and they can help.
There is no fixed limit. Many users create separate workspaces for personal projects, clients, or different teams.
There’s no built-in option to move a chat between workspaces. Contact support with the chat link and the workspace you’d like to move it to, and the team can help.
The workspace continues to exist but reverts to the Free plan’s limits at the end of the billing period. Your published app stays accessible on the default Macaly subdomain, but custom domains and Pro features stop working unless you switch to the Starter plan, which keeps one app on your own custom domain. The Free plan includes 1 published app. If the workspace has more live apps, the owners and admins get an email and time to choose which one stays live. The other apps are unpublished afterwards, but your projects and data stay.

​
Support

The team aims to respond within one business day. Support is based in Europe (CET timezone) and is closed on weekends. During holiday periods responses may take a bit longer.
Contact support. Include the link to the affected chat, a description of what happened, and approximately when. Before contacting support, use the Share feedback button on the problematic agent response. It attaches useful context for the engineering team.
Yes. status.macaly.com shows information about active incidents and recent outages.