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. The Visual Edit mode lets you click directly on text, images, and other elements in the preview and change them without sending a message to the agent. Direct text edits happen immediately and use no credits. Some visual changes (like adjusting images or layouts) may involve AI and use fewer credits than a regular prompt, but changes are always scoped to the selected element.
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.com). 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.

​
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 no-reply@macaly.dev. 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.

​
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

Macaly projects use Convex as the backend database. You can view and manage your data through the Database tab inside the Macaly editor.
Yes. Contact support and request a database snapshot for your project (include your project link). You will receive a download link for a ZIP file. Create your own Convex account, import the snapshot following the guide at docs.convex.dev, then update the Convex secrets in your Macaly project settings. There will be brief downtime during the cutover.
Yes. You can continue developing with Macaly after migrating to your own Convex database. The Database tab inside Macaly will no longer work, but all other functionality continues normally.

​
SEO

Macaly generates SEO-friendly sites by default. You can ask the agent to optimize SEO at any time, or manually edit meta tags, page titles, and descriptions in Settings → SEO.
Google indexing takes time, often days to weeks after publishing. To speed up discovery, submit your site URL to Google Search Console at search.google.com/search-console. Also share your URL on social media, as Google crawls links it finds on the web.
Technically yes, using your published Macaly URL in an iframe. However, content inside iframes is poorly indexed by search engines, which will hurt 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.