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 Ask AI on text or an image, which does use credits and shows the price before you run it.
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.

​
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 3 million credits per month. Paid plan credits are valid for 30 days. Pro plan users 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 Pro plan, 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 Pro plan.
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 and switches to the Free or Hosting plan take effect at the end of your current billing period.
If you are on a Pro plan, 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 3 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.
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 Hosting plan ($5/month) keeps your custom domain connected and the Made with Macaly badge hidden. It does not include any AI credits for editing. If you need to make further changes, switch to a Pro plan to get credits.To switch from Pro to Hosting, click Manage on your current plan, select Cancel subscription, and choose Hosting before your plan is cancelled.
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 Hosting plan ($5/month) — just select it 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 Pro or Hosting plan.
This is a known issue where the build completes but the UI does not update. Contact support with your project link and they will manually reset the publish state. Your site is most likely already live even if the dashboard still shows building.
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 after publishing, try duplicating the chat and republishing from the duplicate. This often resolves stale deployment issues.
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; Pro plans and above 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 Pro or 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. 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 not available on the Free plan. To use the Hosting plan, you need to upgrade to a Pro plan first.
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, try duplicating the chat using Start Fresh (No Messages). This usually resolves the issue. If not, contact support with the chat link. Any credits consumed during a confirmed stuck session will be reviewed and returned.
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.
Duplicate your chat whenever the project is in a good state, especially before making larger changes. Use Keep Everything (With Messages) to preserve the full chat history, or Start Fresh (No Messages) to carry over the project code without the chat history. Each duplicate has its own separate database.
Yes. Under any agent response in the chat, there is a Restore this version button. Clicking it reverts the project code to the state it was in when that response was generated.

​
AI models

Yes. Macaly runs on several models from different companies, and you can pick which one the agent uses. Claude Sonnet 5 is the default and works well for most projects. 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, and it is the biggest factor. A model built for complex work uses noticeably more credits than one built for speed, because it spends more effort working through the detail. 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 or US, which is where its servers are. 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.
This is often caused by your browser’s automatic page translation interfering with the Macaly editor. Disable browser translation for the macaly.com domain and try again. 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. Choose Start Fresh (No Messages) to copy the project code, content, and files without the chat history. This is useful when reusing a project as a template. Choose Keep Everything (With Messages) to copy the full project including all messages and history. This is useful as a backup before bigger changes. Secrets are automatically transferred to the duplicated chat.
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.
No. The database is included in every plan and using it doesn’t consume credits. Each plan does have a monthly usage allowance. 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. You can only publish your project from the Live database.
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 only checks your site after you publish. If you haven’t published your project yet, publish it and the audit will run automatically.
The audit reflects your last published version. If you’ve changed something since then, publish your project again and the audit results will refresh.
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 3M 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 projects stay accessible on the default Macaly subdomain, but custom domains and Pro features stop working unless you switch to the Hosting plan.

​
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.