> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions about Macaly

## Getting Started

<AccordionGroup>
  <Accordion title="What kinds of projects can I build with Macaly?">
    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.
  </Accordion>

  <Accordion title="What types of projects is Macaly not suitable for?">
    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.
  </Accordion>

  <Accordion title="Can I build my project in a language other than English?">
    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.
  </Accordion>

  <Accordion title="Does Macaly support user authentication and login?">
    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.
  </Accordion>

  <Accordion title="Can I edit text and small design changes without using credits?">
    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.
  </Accordion>

  <Accordion title="Can I use Macaly on my phone, or do I need to download an app?">
    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.
  </Accordion>
</AccordionGroup>

## Plans and credits

<AccordionGroup>
  <Accordion title="How does the credit system work?">
    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.
  </Accordion>

  <Accordion title="Do credits roll over to the next month?">
    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.
  </Accordion>

  <Accordion title="Can I buy extra credits without upgrading my plan?">
    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.
  </Accordion>

  <Accordion title="Can I upgrade or downgrade my plan at any time?">
    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.
  </Accordion>

  <Accordion title="What happens if I run out of credits?">
    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.
  </Accordion>

  <Accordion title="Why do I have 0 credits if I have not used any?">
    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](mailto:support@macaly.com). They can investigate your account. Paid plan credits are added at the start of each 30-day billing cycle.
  </Accordion>

  <Accordion title="Macaly had an issue and consumed my credits. Can I get a refund?">
    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](mailto:support@macaly.com) 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](mailto:support@macaly.com) and the team will investigate on a case-by-case basis.
  </Accordion>

  <Accordion title="How do I apply a promo or discount code?">
    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](mailto:support@macaly.com) with your code and the team will apply the discount to your account manually.
  </Accordion>

  <Accordion title="What happens if I am on an old Pro, Plus, or Ultra plan?">
    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.
  </Accordion>
</AccordionGroup>

## Billing & Subscriptions

<AccordionGroup>
  <Accordion title="How do I cancel my subscription?">
    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.
  </Accordion>

  <Accordion title="Which currencies can I be billed in?">
    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.
  </Accordion>

  <Accordion title="Can I change my billing currency after subscribing?">
    You can change your billing currency freely before you start a subscription. If you already have an active subscription, [contact support](mailto:support@macaly.com) and the team will change it for you.
  </Accordion>

  <Accordion title="How do I find my invoices and receipts?">
    Go to macaly.com/billing and click the **Invoices** tab. All past invoices are listed there and can be downloaded individually.
  </Accordion>

  <Accordion title="Why was I charged more than expected?">
    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](mailto:support@macaly.com). They can process a refund if credits from the upgraded tier have not yet been used.
  </Accordion>

  <Accordion title="Can I get a refund on a subscription renewal I forgot to cancel?">
    [Contact support](mailto:support@macaly.com) 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.
  </Accordion>

  <Accordion title="Is there a plan just for keeping my site live without editing?">
    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.
  </Accordion>

  <Accordion title="What happens to my custom domain if I cancel my Pro plan?">
    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.
  </Accordion>
</AccordionGroup>

## Publishing & Deployment

<AccordionGroup>
  <Accordion title="How do I publish my project?">
    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.
  </Accordion>

  <Accordion title="The publish process has been stuck on building for a long time. What should I do?">
    This is a known issue where the build completes but the UI does not update. [Contact support](mailto:support@macaly.com) 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.
  </Accordion>

  <Accordion title="My preview shows changes but my live site does not reflect them. Why?">
    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.
  </Accordion>

  <Accordion title="Can I download the source code of my project?">
    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.
  </Accordion>
</AccordionGroup>

## Domains & Hosting

<AccordionGroup>
  <Accordion title="How do I connect my own custom domain?">
    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.
  </Accordion>

  <Accordion title="What DNS records do I need to add for my custom domain?">
    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.
  </Accordion>

  <Accordion title="My site works at www but shows an SSL error at the bare domain. How do I fix it?">
    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](mailto:support@macaly.com) if you are unsure which records to remove.
  </Accordion>

  <Accordion title="My domain still shows Pending or Not connected. What should I do?">
    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.
  </Accordion>

  <Accordion title="Can I purchase the Hosting plan if I'm on the Free plan?">
    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.
  </Accordion>

  <Accordion title="Can I set up email for my custom domain?">
    Macaly does not provide email hosting. For email on your custom domain (e.g. [info@yoursite.com](mailto: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.
  </Accordion>
</AccordionGroup>

## Email & Notifications

<AccordionGroup>
  <Accordion title="Can Macaly send emails from my project?">
    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.
  </Accordion>

  <Accordion title="What are the email sending limits?">
    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.
  </Accordion>

  <Accordion title="My OTP login emails are not arriving. What should I do?">
    First, check your spam or junk folder. If emails are truly not arriving, [contact support](mailto:support@macaly.com) with the link to your project and the email address involved. The team can investigate email delivery on the backend.
  </Accordion>
</AccordionGroup>

## Working with the Agent

<AccordionGroup>
  <Accordion title="The agent got stuck or is taking too long. What can I do?">
    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](mailto:support@macaly.com) with the chat link. Any credits consumed during a confirmed stuck session will be reviewed and returned.
  </Accordion>

  <Accordion title="The agent keeps making the same error. How do I avoid burning credits?">
    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.
  </Accordion>

  <Accordion title="How many steps can the agent take per request?">
    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.
  </Accordion>

  <Accordion title="How do I create a backup of my project?">
    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.
  </Accordion>

  <Accordion title="Can I restore a previous version of my project?">
    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.
  </Accordion>
</AccordionGroup>

## Technical Issues & Errors

<AccordionGroup>
  <Accordion title="What does Error code 524 or a Cloudflare timeout mean?">
    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](mailto:support@macaly.com) with your chat link. You can check for ongoing incidents at status.macaly.com.
  </Accordion>

  <Accordion title="The preview says Failed to Start or the development server crashed. What should I do?">
    The sandbox server crashed. It should restart automatically within one to two minutes. If it does not, [contact support](mailto:support@macaly.com) with your chat link. The team can restart the sandbox and refund any credits consumed during the outage.
  </Accordion>

  <Accordion title="I get &#x22;Application error: a client-side exception has occurred&#x22;. What is wrong?">
    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](mailto:support@macaly.com).
  </Accordion>

  <Accordion title="Image uploads are failing. What are the size limits?">
    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](mailto:support@macaly.com).
  </Accordion>
</AccordionGroup>

## Duplicating Projects

<AccordionGroup>
  <Accordion title="How do I duplicate a project?">
    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.
  </Accordion>

  <Accordion title="Do duplicates share the same database?">
    No. Each duplicate gets its own separate database.
  </Accordion>

  <Accordion title="Can I share my project so someone else can duplicate it into their account?">
    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.
  </Accordion>

  <Accordion title="I build websites for clients. Can they take the site over 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.
  </Accordion>
</AccordionGroup>

## Databases

<AccordionGroup>
  <Accordion title="What database does Macaly use?">
    Macaly projects use Convex as the backend database. You can view and manage your data through the **Database** tab inside the Macaly editor.
  </Accordion>

  <Accordion title="Can I migrate my project database to my own Convex account?">
    Yes. [Contact support](mailto:support@macaly.com) 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.
  </Accordion>

  <Accordion title="If I switch to my own Convex database, can I still use Macaly to build?">
    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.
  </Accordion>
</AccordionGroup>

## SEO

<AccordionGroup>
  <Accordion title="How does Macaly handle 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**.
  </Accordion>

  <Accordion title="My site is not appearing in Google search. What can I do?">
    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.
  </Accordion>

  <Accordion title="Can I embed a Macaly site in another website using an iframe?">
    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.
  </Accordion>
</AccordionGroup>

## Accounts

<AccordionGroup>
  <Accordion title="What's the difference between my account and a workspace?">
    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.
  </Accordion>

  <Accordion title="Why do some settings change when I switch workspaces?">
    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.
  </Accordion>

  <Accordion title="How do I change my email address?">
    [Contact support](mailto:support@macaly.com) 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.
  </Accordion>

  <Accordion title="I cannot log in and I am not receiving OTP emails.">
    Check your spam or junk folder first. If the email is not arriving at all, [contact support](mailto:support@macaly.com). They can verify your account status and help with authentication.
  </Accordion>

  <Accordion title="How do I sign out of other devices?">
    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.
  </Accordion>

  <Accordion title="How do I permanently delete my account?">
    [Contact support](mailto:support@macaly.com) 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.
  </Accordion>
</AccordionGroup>

## Workspaces

<AccordionGroup>
  <Accordion title="Do workspaces share credits?">
    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.
  </Accordion>

  <Accordion title="Do I get free credits in every workspace I create?">
    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.
  </Accordion>

  <Accordion title="What happens to my projects if I delete a workspace?">
    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.
  </Accordion>

  <Accordion title="Can a workspace have more than one Owner?">
    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.
  </Accordion>

  <Accordion title="Can I transfer ownership of a workspace to someone else?">
    Workspace ownership cannot currently be transferred through the interface. If you need to change the Owner of a workspace, [contact support](mailto:support@macaly.com) and they can help.
  </Accordion>

  <Accordion title="How many workspaces can I have?">
    There is no fixed limit. Many users create separate workspaces for personal projects, clients, or different teams.
  </Accordion>

  <Accordion title="Can I move a chat from one workspace to another?">
    There's no built-in option to move a chat between workspaces. [Contact support](mailto:support@macaly.com) with the chat link and the workspace you'd like to move it to, and the team can help.
  </Accordion>

  <Accordion title="What happens if I cancel the paid plan on one of my workspaces?">
    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.
  </Accordion>
</AccordionGroup>

## Support

<AccordionGroup>
  <Accordion title="How quickly does Macaly support respond?">
    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.
  </Accordion>

  <Accordion title="How do I report a bug that wasted my credits?">
    [Contact support](mailto:support@macaly.com). 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.
  </Accordion>

  <Accordion title="Is there a status page where I can check for outages?">
    Yes. [status.macaly.com](https://status.macaly.com) shows information about active incidents and recent outages.
  </Accordion>
</AccordionGroup>