How can we help?

Search for the articles here or browse the categories below.

Recent Updates

Product changes and announcements worth knowing about.

Atlas Brain Now Uses AI Agent Credits: What Changed and Where to See Your Usage

As Atlas Brain continues to develop, we are standardizing how AI-powered usage is managed across the platform. This is a necessary step to help us manage usage consistently, maintain a reliable experience, and continue investing in Atlas Brain. Atlas Brain was previously available without a separate usage quota and is now moving to a plan-based quota model that uses AI Agent credits. We understand that changes to a familiar product experience can raise important questions. To support this transition, we have added a 10% Atlas Brain bonus quota for this month. This article explains what is changing, how the transition works, where to check your usage, and what options are available if you need additional quota. What changed with Atlas Brain quotas? Atlas Brain used to be available without a set limit. It now uses a quota that depends on your plan, like other Search Atlas tools. Each Atlas Brain task uses credits from your plan, and the amount depends on how much work the task needs. A short question uses fewer credits than a long, multi-step task. Did I get any extra Atlas Brain quota during the transition? Yes. To make the change easier, we added a 10% bonus to your Atlas Brain quota for this month. It was applied automatically, and you do not need to do anything. The bonus applies only to Atlas Brain. All other platform quotas and tool limits stay at your standard plan levels. Where can I see my Atlas Brain usage? Go to Billing in your dashboard to see your current usage and remaining quota. Inside an Atlas Brain chat, a banner above the message box also warns you when your credits are running low. Can I see which Atlas Brain tasks used my credits? You can see how many Atlas Brain credits you have used in total, and a history of each time credits were charged. You cannot yet see which specific chat or task each charge belongs to. Go to Billing. The Atlas Agent Credits tile shows how many credits you have used out of your total. If your account is on the new billing system, the Quota Log tab lists each charge with its amount and date. A per-task breakdown is not available today. We have shared this feedback with our team. When does my quota reset? Your Atlas Brain quota resets with your billing cycle, together with the rest of your plan quotas. What happens when I run out of Atlas Brain quota? Atlas Brain shows the message "You're out of AI Agent credits." You can add more credits from Billing or move to a plan with a larger allowance. Your projects, reports, and other Search Atlas tools are not affected. Can I use Hyperdrive Credits (HDC) for Atlas Brain? No. Hyperdrive Credits can only be used to top up URL Indexer quota. They cannot be used for Atlas Brain. What if the new quota is not enough for my team? If your team needs more than your plan includes, reach out through live chat. We can review your current usage and check whether a higher plan or an adjustment fits your workflow. Why wasn't this announced before it happened? We rolled this update out quickly to standardize how quotas work across the platform, and we applied the 10% Atlas Brain bonus to every account to bridge the transition. We have shared your feedback with our team so future updates are communicated sooner.

Browse by topic

Find guides, tutorials, and answers organised by category.

🚀

Start Here & Resources

Getting started, platform basics, training, product updates and how to reach support.

Browse

🤖

Coworker

Atlas Agent / Coworker: chat, tasks, playbooks and routines.

Fixing errors, routing issues, and unexpected agent responses.

Browse

Popular articles

What other people are reading right now.

🦦 OTTO SEO

🔗 Add Service Pages to OTTO Links

🔗 Overview OTTO SEO’s Internal Link Suggestions tool does not automatically import service or location pages from Brand Vault. To use these pages in link recommendations, add each one manually through Add Page. 📍 Open Internal Link Suggestions 1. In the Search Atlas left sidebar, select OTTO SEO. 2. Open the Internal Link Suggestions section. 3. Select Add Page to create a suggestion. ➕ Add a Service or Location Page 1. In the Destination page field, enter the service or location page you want to promote. 2. In the Source page field, enter the page where OTTO should place the internal link. 3. Review both URLs to confirm they are correct and use the preferred versions of the pages. 4. Save the suggestion. Repeat these steps for each service and location page. For example, you can set a service page as the destination and a related city or blog page as the source. ✅ Check Your Suggestions After saving the entries, review the Internal Link Suggestions list to confirm that each destination page has an appropriate source page. Use relevant page pairings so visitors and search engines can easily discover related content. 💡 Important Limitation Content Genius may not show your complete list of service and location pages because these pages are not automatically imported from Brand Vault into Internal Link Suggestions. This is expected behavior. Adding the pages manually is currently required. 🛠️ Need Help? If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be instantly connected with a member of our team.

Troubleshooting: Conversion Tracking & Retargeting

🚀 Troubleshoot OTTO PPC Retargeting

🔍 Why a business may not appear OTTO PPC retargeting only shows businesses that meet the campaign requirements and are available in your current Search Atlas account. A business may be missing or unavailable when: - The business is not connected to the correct Search Atlas project. - The project is inactive, incomplete, or still being processed. - Your account does not have the required access to the business or advertising account. - The required advertising connection, audience, or tracking setup is missing. - The business is already assigned to another campaign or is not eligible for retargeting. - Recent project or connection changes have not finished syncing. 🛠️ Check the project and business 1. Open Search Atlas and select the correct project. 2. In the left sidebar, open OTTO SEO. 3. Confirm that the project is active and that the business details, domain, and location are correct. 4. Open the OTTO PPC retargeting campaign setup and review the available business list. 5. If the business is listed, select it and continue the campaign setup. 🔗 Verify account connections Confirm that the advertising account and required retargeting resources are connected to the same business and project. Check that: - You are signed in with an account that has permission to manage the advertising account. - The selected advertising account belongs to the intended business. - Audience or tracking resources have been created and are available for use. - No connection is paused, expired, disconnected, or awaiting authorization. 🔄 Refresh the available businesses If you recently added a business, changed permissions, or connected an advertising account, allow time for the information to sync. Then refresh the page, reopen the campaign, and check the business list again. Avoid creating duplicate projects while the existing project is syncing. ⚠️ If the business is still unavailable 1. Confirm you are working in the correct Search Atlas workspace and project. 2. Check whether the business is inactive or already used by another retargeting campaign. 3. Reconnect or reauthorize the relevant advertising account if the connection shows an error. 4. Make sure the business has valid details and an eligible website or audience. 5. Record the project name, business name, advertising account, and any error message before requesting help. If the business remains unavailable after these checks, open the chat widget in the bottom-right corner of the platform and type human teammate to be instantly connected with a member of our team.

Playbooks, Routines & Golden Loops

🤖 Fix Unfinished Playbook Names

🔎 What happened An unfinished working note may have been saved or published as the name of a playbook in the Playbook Library. This can make an internal draft appear as a customer-facing or reusable playbook title. 🛠️ What to check 1. Open the Playbook Library. 2. Find the playbook with the unfinished note as its name. 3. Open the playbook and review its title, instructions, and status. 4. Confirm whether the content is a draft, an active playbook, or an accidental publication. ✏️ Correct the playbook 1. Rename the playbook with a clear, descriptive title. 2. Remove unfinished notes, placeholders, and internal comments from the playbook content. 3. Save the updated playbook. 4. If the playbook was published accidentally, unpublish or archive it when that option is available in your workspace. 5. Refresh the Playbook Library and confirm that the corrected name appears. ✅ Prevent the issue - Use a clear title before saving a new playbook. - Keep working notes separate from final playbook instructions. - Review the title and content before publishing. - Use draft status while the playbook is still being edited. 🚨 If the issue continues If an unfinished working note is published again, or you cannot rename, unpublish, or archive the affected playbook, record the playbook name and the steps that caused the issue. Avoid deleting the playbook until the issue has been reviewed. If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be instantly connected with a member of our team.

Troubleshooting: Heatmap Issues

🔍 Duplicate Geogrid Scans and Credits

🔍 Why duplicate scans can happen Geogrid scans run asynchronously, which means processing may continue after a scan is submitted. In some cases, a recovery process can incorrectly treat an active scan as stuck in PENDING status and start it again. This can create duplicate provider work and duplicate geogrid pin records. This issue is related to scan recovery handling, not the monthly automation schedule. Automated scans are still intended to run only once during their scheduled interval. 💳 Are duplicate scans charged twice? Not necessarily. In the reported incident, the duplicate scan activity did not result in a second geogrid credit charge. Duplicate processing and duplicate credit usage are separate issues, so your credit balance must be checked before restoration is considered. 🛠️ What happens to affected credits? Credit restoration is reviewed case by case. The current fix is designed to prevent recovery sweepers from restarting scans that still have asynchronous processing or an active batch job. Credit restoration is not automatically included in that fix. If your balance appears lower than expected, keep the affected project, scan dates, and geogrid details available for review. The team can verify whether credits were actually deducted and determine the appropriate next step. ✅ How to report a duplicate scan 1. Open the affected project and identify the duplicate geogrid scans. 2. Record the scan dates, approximate times, location settings, and affected keywords. 3. Compare your geogrid credit balance before and after the scans, if that information is available. 4. Open the chat widget in the bottom-right corner of the platform and type human teammate to be instantly connected with a member of our team. 🚀 How Search Atlas is preventing repeats The prevention work updates recovery checks so they skip geogrids with asynchronous processing still pending or with a live batch job. This helps prevent an in-flight scan from being mistaken for a stuck scan and dispatched again. Until the prevention update is fully available, a duplicate-looking result does not always mean that two credits were charged. Verification of the account activity is required.

Troubleshooting: Keyword Data Missing or Zero

🔍 Find Missing Keyword Lists

🔍 What to check first If a keyword list does not appear after creation, do not recreate it immediately. The list may still be loading, may have been saved under another project or site, or may not have finished saving. 📋 Check your keyword lists 1. Open Keywords → Keyword Research from the left sidebar. 2. Open the Keyword lists tab. 3. Use Search List to search for the list name, a distinctive keyword, or part of the list. 4. Refresh the page and check again after a few moments. 🕘 Review keyword research history If the list is not visible, open Keywords → Keyword Research → History. Select Search History or View to find the search that produced the keywords. From there, check whether the results can be viewed or saved to a list. 🏢 Confirm the workspace and project Keyword lists are associated with the workspace, project, client, or site where they were created. Confirm that you are viewing the same workspace and project used during creation. If you manage multiple clients or sites, switch to each relevant project and check Keywords → Keyword Research → Keyword lists again. 💳 Check before creating the list again Before repeating the search or creating another list, confirm whether your quota points were deducted in the original workspace or project. If the search appears in history or quota usage shows a deduction, avoid repeating the action until the original list is located. This helps prevent duplicate lists and possible duplicate usage. 🛠️ When the list still cannot be found Record the list size, approximate creation time, list name, keywords or search terms, workspace, client, site, and project. Also note whether quota points were deducted and include screenshots if available. This information helps identify whether the issue is related to loading, account scope, or list persistence. If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be instantly connected with a member of our team.

Troubleshooting: Pixel Pending, UUID & Verification Errors

🔧 Fix OTTO SEO Tag Detection and Invoice Emails

🧭 Overview This article covers two common questions in one place: why OTTO SEO may fail to detect its tag on your website, and how to configure automatic monthly invoice emails. Both are straightforward to resolve once you know where to look. 🏷️ Why OTTO SEO Is Not Detecting the Tag If OTTO SEO cannot verify its tag on your website, the most common cause is a Content Security Policy (CSP) blocking the tag from loading or being recognised. A CSP is a security header that controls which external scripts and resources a browser is allowed to execute on your site. To access OTTO SEO, go to the left sidebar and select OTTO SEO → SEO Automation (URL: /seo-automation-v3). From there you can view your tag status and troubleshoot detection issues. 🔍 How to Confirm a CSP Is the Problem 1. Open your website in Google Chrome. 2. Right-click anywhere on the page and select Inspect. 3. Click the Console tab. 4. Reload the page and look for error messages that include the words Content Security Policy or CSP. 5. If you see a CSP error referencing the Search Atlas or OTTO SEO script domain, your policy is blocking the tag. ✅ How to Fix the CSP Block You need to add the Search Atlas script domain to your site's CSP allowlist. The exact steps depend on how your CSP is set — it may be configured in your web server settings, a plugin, a CDN such as Cloudflare, or directly in your site's code. 1. Locate where your CSP header is defined (server config, .htaccess, CDN dashboard, or a security plugin). 2. Find the script-src directive in your policy. 3. Add the OTTO SEO script domain to that directive. If you are unsure of the exact domain to whitelist, open the chat widget in the bottom-right corner of the platform and type human teammate — our team will provide the correct domain for your account. 4. Save your changes and clear any server or CDN cache. 5. Return to OTTO SEO in Search Atlas and click Verify Tag to confirm detection is successful. If your site is managed by a developer or a hosting provider, share these instructions with them so they can update the CSP on your behalf. 📬 How to Set Up Automatic Monthly Invoice Emails Search Atlas can automatically send your invoices by email each billing cycle so you never have to download them manually. Follow the steps below to configure this. 1. Click your account avatar or initials in the top-right corner of the platform. 2. Select Billing or Billing & Subscription from the dropdown menu. 3. Navigate to Billing → Invoices (Invoices page). 4. Enter the email address (or addresses) where invoices should be delivered each month. 5. Toggle on Send invoice by email or Automatic invoice delivery if the option is present. 6. Click Save to confirm your settings. Once saved, a PDF invoice will be emailed to the specified address automatically after each successful monthly charge. You can add multiple email addresses — useful if your finance team needs a copy alongside your primary account owner. 💡 Tips for Managing Billing Emails - Use a shared inbox: Adding a finance or accounts-payable email address ensures invoices reach the right person even if team members change. - Check your spam folder: The first automated invoice email may be filtered. Mark it as safe to avoid future delivery issues. - Download past invoices: Historical invoices are always available in the Billing section of your account if you need to retrieve them manually. 🆘 Still Need Help? If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.