Understand what each status means, why files land there, and what to do about it
This article contains:
- How monitoring works
- The status cards
- Supported file types & size limits
- The "Summary" panel
- The "File Details" table
- Quick FAQ
How monitoring works
Every file we discover in your connected source (SharePoint, Egnyte, OneNote, etc.) moves through an ingestion pipeline. As it moves, we record its current status. The Monitoring page groups your files by that status so you can see, in real time, what is searchable, what is still in progress, and what could not be ingested.
At a high level, files split into:
- Supported files — file types we can ingest, which end up Synced, Processing, or Failed.
- Unsupported files — files we cannot ingest (wrong type, too large, corrupted, password-protected, etc.). They never block your sync.
- Rate limited — files we could not yet retrieve from the source because it throttled us. These are not yet classified — once we successfully fetch the file, it will resolve into one of the buckets above (Supported → Synced/Processing/Failed, or Unsupported).
Total files = Supported files + Unsupported files.
The status cards (top row)
Synced
What it means: The file was fully processed and is now searchable in AlphaSense.
- This is the successful end state. A file counts as Synced only after content extraction and indexing both complete.
- The
100% · 0.21 GBline shows how much of your supported files have reached this state.
Do I need to do anything? No. This is the healthy, finished state.
Processing
What it means: The file has been picked up and is moving through the ingestion pipeline (downloading, converting, extracting, or indexing), but hasn't finished yet.
- Newly added or recently updated files sit here temporarily.
- Large files, or large batches, naturally take longer.
Do I need to do anything? No — just wait. Files here resolve to Synced on success, or to Failed / Unsupported if the file can't be completed. If a file stays in Processing for an unusually long time, it will be automatically re-checked and reclassified.
Failed
What it means: The file is supported, but processing did not complete because of an error in the pipeline or a downstream service.
- These are typically transient / system-side issues (indexing errors, temporary service errors, delivery delays, storage upload errors, etc.), not problems with your file itself.
- Most failures are retried automatically by the platform.
Do I need to do anything? Usually no — these are retried on our side. If a file remains Failed for an extended period, contact AlphaSense support with the file name/ID.
-
What kinds of issues land here? (internal error codes)
Code Meaning ER101 Integration service error ER102 Invalid / malformed payload from connector ER402 Indexing error ER501/ER601 Ingestion pipeline error ER505 Document storage upload error ER801 Search pipeline delay These codes are internal and shown here for support reference only.
Unsupported
What it means: The file cannot be ingested and has been skipped. This is a permanent state for that file as-is — nothing is wrong with the platform.
- Common reasons: unsupported file type, file too large, too many pages, empty file, corrupted file, password-protected, unsupported (unicode) characters in the name/path, file cannot be converted, file not found at source, or access not granted.
- Unsupported files are not counted against your supported-file total and never block the rest of your sync.
Do I need to do anything? Only if you want that file searchable. Depending on the reason, you may be able to fix it at the source (e.g. remove the password, convert to a supported type, reduce the size/page count, rename to remove special characters, or grant access) and re-sync. See Supported file types & size limits below for the rules.
Common "Unsupported" reasons (internal skip codes)
| Code | Reason | Fixable at source? |
|---|---|---|
| SK02 | Unsupported file type — see Supported file types & size limits | Convert to a supported format |
| SK03 | File too large — see Supported file types & size limits | Split / reduce size |
| SK04 / SK09 | Unsupported (unicode) characters in file/folder name | Rename to remove special characters |
| SK05 | Password protected | Remove the password |
| SK06 / SK10 | Corrupted file / folder | Repair or re-upload |
| SK13 | Empty file | Add content |
| SK14 | File cannot be converted | Convert to a supported format manually |
| SK15 | Too many pages (over 2,000) | Split into multiple documents |
| SK16 | Folder nesting limit exceeded (deeper than 3 levels) | Flatten the folder structure |
| SK17 | Skipped due to a feature-flag restriction (this content type/feature isn't enabled for your account) | Contact AlphaSense support |
| SK18 | File not found at source — it may have been deleted or moved | Re-add it at the source |
| SK19 | Access to the file was not granted by the source | Grant access at the source |
| SK20 | Could not be retrieved from source | Retry / check source |
Supported file types & size limits
Whether a file is Supported or Unsupported is decided by two checks up front: its type (extension) and its size. Files that pass both flow into the pipeline; files that fail are skipped with a specific reason (see the code table in Unsupported).
Supported file types
We can ingest the following formats. Anything outside this list is marked Unsupported → Unsupported File Type (SK02).
| Category | Extensions |
|---|---|
| Documents |
pdf, doc, docx, txt, html, htm, xml, json
|
| Spreadsheets |
xls, xlsx, xlsb, xlsm, csv, tsv, ods
|
| Presentations |
ppt, pptx
|
msg, eml
|
|
| Notebooks |
one (OneNote) |
| Images |
jpg, jpeg, png, bmp, gif
|
| Archives | zip |
Archives (zip) are opened and their contents are evaluated individually against these same type and size rules. Files inside a zip that aren't supported are skipped just like standalone files.
Size limits
Each file type has a maximum size. Files above the cap for their category are skipped as Unsupported → File Too Large (SK03). Limits differ by category:
| Category | Size cap |
|---|---|
| Standard files (documents, spreadsheets, presentations, email, etc.) | 100 MB |
Images (jpg, jpeg, png, bmp, gif) |
20 MB |
Archives (zip) |
200 MB |
Other content limits
A supported, correctly-sized file can still be skipped if it breaks one of these content rules:
| Rule | Skipped as | Code |
|---|---|---|
| More than 2,000 pages in a single document | Too Many Pages — split into multiple documents | SK15 |
| Folder nested more than 3 levels deep | Nesting Limit Exceeded — flatten the folder structure | SK16 |
| Empty file (no content) | Empty File | SK13 |
| File cannot be converted | Conversion Failed | SK14 |
| Unsupported characters (unicode) in file/folder name | Unsupported Characters — rename to remove them |
SK04 / SK09
|
| Password-protected | Password Protected — remove the password | SK05 |
| Corrupted | Corrupted File / Folder |
SK06 / SK10
|
Rate limited
What it means: The source system (e.g. SharePoint/Microsoft) temporarily throttled our requests, so we could not yet retrieve these files.
- This is temporary and automatic — the platform backs off and retries later on its own.
- It reflects source-side throttling, not an issue with your file or configuration.
- Rate limited is not a final verdict. Until we successfully fetch the file from the source, we don't yet know whether it's supported. Once retrieved, a rate-limited file resolves into one of the other buckets — it may become Synced, sit in Processing, land in Failed, or turn out to be Unsupported.
Do I need to do anything? No. Rate-limited files are retried automatically; each will be re-classified once the throttle clears and we can read it.
The "Summary" panel
The donut and the three rows below it recap the same data at the file-portfolio level:
| Row | What it counts |
|---|---|
| Total files | Every file we discovered in the source (supported + unsupported). |
| Supported files | Files whose type we can ingest — the ones flowing through Synced / Processing / Failed. |
| Unsupported | Files that cannot be ingested and were skipped (see Unsupported above). Expand for the per-reason breakdown. |
| Rate limited | Files we couldn't yet retrieve due to source throttling; retried and classified automatically. |
Click the › on Supported Files or Unsupported to drill into the per-reason breakdown.
The "File Details" table
The search box plus the status chips (Synced, Processing, Failed, Rate limited, Unsupported) let you filter the file list by any of the statuses defined above. Use it to:
- Search for a specific document by title or file ID.
- Filter to a single status (e.g. show only Unsupported files to decide which to fix).
- Track a file's progress as new data is automatically synced.
Quick FAQ
Q: My file is "Failed" — did I do something wrong? No. Failed almost always means a temporary, system-side issue that we retry automatically. Unsupported is the category tied to the file itself.
Q: Why is my supported-files percentage below 100%? Some files are still Processing or temporarily Failed, and some may be Rate limited (not yet retrieved). Processing/Failed files aren't guaranteed to become Synced — depending on the content they may resolve to a permanent Failed or Unsupported state.
Q: My file type isn't in the supported list — can I still ingest it? Only if you convert it to a supported format first (e.g. export to pdf or docx), then re-sync.
Q: Will unsupported or rate-limited files block my other files? No. Each file is tracked independently; skipped or throttled files never hold up the rest of your sync.
Q: How fresh is this data? The page shows the last refresh time at the top right. Use Refresh to pull the latest.