Troubleshoot source processing
Find the active or failed stage in the processing panel, then use the matching recovery below. Wait while a stage is active. Change the input when Atlas reports a failure.
Wait for pending work before retrying
A newly added source can remain in Adding source, Queued / preparing, or another active stage while Atlas works. Let that attempt finish before adding the same file or URL again.
For PDFs, the panel identifies the current stage, such as Reading content, Rendering pages, or Building search index. You can open rendered pages before search indexing finishes, but search and chat may remain limited until their stages are ready.
Make one corrective change for a failed source
Open the failed item in the processing panel. Record the stage and message, then make the smallest change that addresses that failure:
| Source type | Safe corrective change |
|---|---|
| PDF or document | Check the file size, page count, and whether the file opens. Upload another copy if the file is damaged. |
| Website | Use a direct public article URL rather than a login, search, consent, or account page. |
| YouTube | Use a video URL with an available transcript. |
| Paper | Use a specific identifier, another search result, or upload the PDF. |
Retry after making the change. If the same stage fails again, include that stage and message when you contact support.
Recover from website and YouTube content problems
If a website link is refused, the message names what happened to the page:
- This page needs a sign-in means the page is behind a login. Download it, or copy the text into a note.
- This page has no text to read means the page loaded without article text. Save it as a PDF, or copy the text into a note.
- This page doesn't exist means the link is broken. Check the link.
- This page didn't load means the attempt can work later. Try again in a moment.
For YouTube, follow the visible message:
- That's not a single video means the URL is for a channel, playlist, or search page. Paste a link to one video.
- This video has no captions means there is no transcript to import. Try a video with captions.
- This video is private or age-restricted or This video isn't available means that video can't be imported.
- This video didn't import means you can try again in a few minutes.
Check limits and escalate safely
If Atlas reports Your source capacity has been reached., remove a source you no longer need or check Plans, usage, and limits.
If the documented recovery does not work, contact support with the source type, project name, time of the attempt, failed stage, and exact visible message. Never include a password or payment information in a support message.