How SEO works in Macaly
Macaly renders your pages on the server. That means search engines like Google and Bing, as well as AI crawlers, get the full content of your page directly in the HTML. That gives every project, right from the start:- Reliable indexing: Your content is in the HTML from the first request, so crawlers can read it without running JavaScript.
- Clean markup: HTML structure, meta tags, and page metadata are generated for you on every page.
- Visibility as soon as you publish: Your pages are visible from the moment you publish them, without you having to set anything up.
SEO health audit
Available on the Pro and Enterprise plans

When the audit runs
The audit runs automatically every time you publish your changes. Macaly re-checks your published site and updates the results. If you make changes without publishing them, the audit warns you that your project has changed since the last publish. Publish it again to see up-to-date results. You can then also run the audit manually.Reading your score
At the top, you’ll see an overall score and a breakdown across seven categories:- Meta tags: Titles, descriptions, canonical URLs, and other page metadata.
- Content: Headings, image alt text, and whether pages have enough text.
- Technical: Sitemap, robots.txt file, broken links, and custom domain.
- Social sharing: Open Graph tags, favicon, and preview images.
- Structured data: JSON-LD schema that helps search engines understand your site.
- AI readiness: How well AI crawlers can access and understand your content.
- Performance: Loading speed and stability (measured with PageSpeed Insights).
Issues to fix
Below the overall score you’ll find the list of issues. Each one shows which category it belongs to and how many pages it affects. Issues come in two levels:- Errors (red) are more serious problems that can hold your site back, like a missing title or very slow loading.
- Warnings (amber) are recommendations that make your site stronger, like a title that’s outside the ideal length or a missing social sharing image.
Fixing issues with AI
You don’t have to fix issues by hand. Macaly can send them straight to the agent in your chat.- Fix all with AI hands the full list of issues to the agent at once. It works through them together and applies the changes.
- Fix on an individual issue sends just that issue to the agent.
Fixes are made by the agent in your chat, so they use credits like any other request. Running the audit itself is free and doesn’t count toward any limits.
Search appearance
Available on the Pro and Enterprise plans

Editing a page
Click Edit on a page to open its settings:- Title: The headline shown in search results.
- Description: The text below the title.
Titles and descriptions have no length limit, but the SEO audit flags titles outside the 30–60 character range and descriptions outside 50–160 characters as issues. Saving writes the changes into your project, so publish them to reach your published site and the next audit.
Site assets
Two assets are used across your whole site:- App Icon (favicon): The small icon shown in browser tabs and bookmarks. Accepts ICO or SVG files up to 100KB.
- Social Media Image: The default image used when your site is shared. Accepts PNG, JPG, or GIF up to 5MB, ideally 1200×630px. Pages that don’t have their own image use this one.
Setting up SEO for the first time
If your project has no metadata yet, you’ll see a Set up SEO button instead of the page list. It asks the agent to write titles and descriptions for your existing pages and to add an app icon and social media image.Frequently asked questions
How does Macaly handle SEO?
How does Macaly handle 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.
Why can't I run the SEO audit?
Why can't I run the SEO audit?
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.
My SEO audit looks out of date. Why?
My SEO audit looks out of date. Why?
The audit reflects your last published version. If you’ve changed something since then, publish your project again and the audit results will refresh.
What is AI readiness?
What is AI readiness?
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.
How do I improve my SEO score?
How do I improve my SEO score?
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.
My site is not appearing in Google search. What can I do?
My site is not appearing in Google search. What can I do?
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.
Can I embed a Macaly site in another website using an iframe?
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 has a negative impact on your SEO. A better approach is to use Macaly as a standalone site with its own custom domain.