---
title: "Troubleshooting"
section: "Analyze"
description: "Fixes for SmartestQA Analyze: AI import and outline errors, step generation, saving, test case links, assessment, folders, archive, documents."
url: https://docs.smartestqa.ai/en/analyze-troubleshooting.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "analyze error problem fix analyze with ai disabled no requirements could be derived analysis failed scanned pdf steps failed save blocked pipeline missing please select a sub requirement first assessment failed archive not owner module documents folder license limit"
---
# Analyze: Troubleshooting

Find the message or symptom you see. Each entry says why it happens, what to check and how to fix it.

## In short

**On this page you can**

- Fix AI wizard errors, from a greyed-out button to failed scenarios.
- Solve save, date and validation messages on requirements.
- Sort out test case links, Automate on a sub and pipeline sync.
- Understand assessment errors and skipped sub-requirements.
- Resolve folder, module, archive and document problems.

**How to use it**

1. Copy the exact message or describe the symptom.
2. Find it under the matching heading (use the page search).
3. Check the points under Check in order.
4. Apply the Fix ; if it persists, write to info@smartestqa.ai with the message and the requirement ID.

## AI wizard: Import and outline

### Problem: **Analyze with AI** is greyed out, or “AI is disabled for project *n*” _(AI)_

- **Why:** The button needs files attached and two project options: [**Enable AI**](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai) and [**AI Document Analysis**](https://docs.smartestqa.ai/en/project-settings-ai.html#what-each-switch-unlocks). Its tooltip names the missing one, for example “Enable 'AI Document Analysis' in Project Panel → AI Options”.
- **Check:** 1. At least one file is attached (“*n* file(s) attached”).
  2. You are not in the Documents folder.
- **Fix:** Ask an Admin to switch the options on in [Project Panel › AI Options](https://docs.smartestqa.ai/en/project-settings-ai.html#capabilities) ([Users cannot open Project Panel](https://docs.smartestqa.ai/en/company-settings-roles.html#admin-screens); see [Roles](https://docs.smartestqa.ai/en/company-settings-roles.html)). Then reload Analyze. See [Before you start](https://docs.smartestqa.ai/en/analyze-import.html#before).

### Problem: “AI API key is not configured (provider=…). Set it in Admin Panel (Smartest AI) or Project Preferences (Own Account).” _(AI)_

- **Why:** AI is on, but the project’s [AI account](https://docs.smartestqa.ai/en/project-settings-ai.html#ai-account) has no key.
- **Fix:** An Admin enters the key for your own AI account in [Project Panel › AI Options](https://docs.smartestqa.ai/en/project-settings-ai.html#own-account), or switches the project to SmartestQA’s AI account. If you use SmartestQA’s account and still see this, write to info@smartestqa.ai.

### Problem: “Selected model/provider does not support image analysis (vision).” _(AI)_

- **Why:** You attached screenshots, and the project’s AI model cannot read images.
- **Fix:** Remove the images and attach the document text, or ask an Admin to choose a model that reads images in [AI Options](https://docs.smartestqa.ai/en/project-settings-ai.html#own-account).

### Problem: “*name* could not be read and was left out of the analysis” / “Could not read file content” _(Import)_

- **Why:** The browser could not read the file, or its type cannot be turned into text. The analysis continues without it.
- **Check:** 1. The file opens on your computer and is not password-protected.
  2. Its type is in the [accepted list](https://docs.smartestqa.ai/en/analyze-import.html#step-import).
  3. Spreadsheets (.xlsx, .xls) may not convert well; save the sheet as .csv instead.
- **Fix:** Re-save the file as .docx, .pdf (with text), .txt or .md and attach it again. For a picture of a document, attach it as a screenshot.

### Problem: “PDF does not contain extractable text. It may be a scanned/image PDF.” _(Import)_

- **Why:** The PDF holds pictures of pages, not text.
- **Fix:** Export the original as a text PDF or .docx, or attach the pages as images (PNG or JPG).

### Problem: “*n* file(s) were already attached and were skipped” _(Import)_

- **Why:** A file with the same name, size and date is already in the list. Nothing is wrong.
- **Fix:** None needed. To replace a file, remove it from the list first.

### Problem: “Please select a file first” / “Please select a folder first” _(Import)_

- **Fix:** Select a requirement folder in the [tree](https://docs.smartestqa.ai/en/analyze-folders.html#tree), attach a file, then click [**Create as Document**](https://docs.smartestqa.ai/en/analyze-folders.html#add-document) or [**Analyze with AI**](https://docs.smartestqa.ai/en/analyze-import.html#step-import) again.

### Problem: “No requirements could be derived. Check the document has readable content, or add a screenshot.” _(Outline)_

- **Why:** The AI answered, but found nothing it could turn into requirements.
- **Check:** 1. The document has real content, not only headings or a table of contents.
  2. It is not a scanned PDF (see [above](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-scanned-pdf)).
  3. [**Additional Instructions for AI**](https://docs.smartestqa.ai/en/analyze-import.html#step-import) does not exclude everything.
- **Fix:** Attach the chapter that describes behaviour, add a screenshot of the screen, or write the flow in a .txt file in plain sentences. Then click [**Analyze with AI**](https://docs.smartestqa.ai/en/analyze-import.html#step-import) again.

### Problem: “Analysis failed” / dialog “Document Analysis” with “Outline generation failed: …” _(Outline)_

- **Why:** The outline request failed. Common reasons: the AI provider returned an error or a quota limit, no readable content reached the server (“No readable document or image content was provided.”, “At least one document or image is required”), or the browser stopped waiting after 3 minutes.
- **Check:** 1. The text after “Outline generation failed:” names the cause.
  2. The document is not very long; a whole manual can exceed what the model handles in time.
- **Fix:** Retry from the dialog. For long documents, split them by chapter or module and run one folder at a time with a [Target scope](https://docs.smartestqa.ai/en/analyze-import.html#scope). For provider errors, see [AI key](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-ai-key) or ask your Admin about the [AI account’s quota](https://docs.smartestqa.ai/en/project-settings-ai.html#ai-account).

### Problem: “No application metadata yet — no page map, no notes. Scenarios will be generated from the document alone.” _(Outline)_

- **Why:** The project has no App Map pages and no active Notes, so the AI knows only the document.
- **Fix:** Generation still works, but steps will rarely match your controls. Map the pages first: [Discover Your App](https://docs.smartestqa.ai/en/discover-your-app.html), [Update map](https://docs.smartestqa.ai/en/discover-app-map.html#update-map) and [Notes](https://docs.smartestqa.ai/en/discover-notes.html#add-notes).

## AI wizard: steps, coverage and Create

### Problem: Scenarios show **failed**: “No steps were produced for this scenario.” / “*n* scenario(s) generated, *m* failed — you can retry the failed ones” _(Steps)_

- **Why:** Step generation runs in batches with a time budget of 420 seconds on the server, and at most 3 generations run at once. A batch that times out, or waits too long for a free slot, leaves its scenarios without steps.
- **Fix:** Keep the failed scenarios selected and click [**Generate steps**](https://docs.smartestqa.ai/en/analyze-import.html#step-scenarios) again; finished ones are skipped. Select fewer scenarios per run if it keeps failing.

### Problem: “Every selected scenario already has steps.” _(Steps)_

- **Fix:** Nothing to do. Click [**Continue to review**](https://docs.smartestqa.ai/en/analyze-import.html#step-scenarios), or select scenarios that still show **outline**.

### Problem: **Continue to review (0)** is greyed out _(Steps)_

- **Why:** None of the selected scenarios has steps yet. See [Wizard counts](https://docs.smartestqa.ai/en/analyze-numbers.html#wizard-counts).
- **Fix:** Click [**Generate steps**](https://docs.smartestqa.ai/en/analyze-import.html#step-scenarios) first.

### Problem: Many steps show ✗ and coverage is red _(Coverage)_

- **Why:** A ✗ step found no matching action in your project. See [Scenario coverage](https://docs.smartestqa.ai/en/analyze-numbers.html#step-coverage).
- **Fix:** [Record the missing controls](https://docs.smartestqa.ai/en/analyze-import.html#coverage-check) with **Record Actions** (web), then click [**Check Coverage**](https://docs.smartestqa.ai/en/analyze-import.html#coverage-check). Next time, set a [Target scope](https://docs.smartestqa.ai/en/analyze-import.html#scope) so the AI uses the right pages’ actions.

### Problem: “Please select a Start Page URL.” / “No URLs available. Please add one.” / “Real URL could not be resolved.” / “Failed to fetch start page URLs.” _(Coverage)_

- **Why:** **Record Actions** needs a Start Page URL with an address for the chosen environment.
- **Fix:** Add one with [**Manage URLs**](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url) or in [Start Page URLs](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url), pick an [environment that has an address](https://docs.smartestqa.ai/en/project-settings-project.html#url-form), and try again. If the browser extension is missing, see [extension not detected](https://docs.smartestqa.ai/en/quick-start-troubleshooting.html#fix-extension-not-detected).

### Problem: “Coverage check failed.” _(Coverage)_

- **Fix:** Reload the page ([save a draft](https://docs.smartestqa.ai/en/analyze-import.html#drafts) first) and click [**Check Coverage**](https://docs.smartestqa.ai/en/analyze-import.html#coverage-check) again. If it keeps failing, write to info@smartestqa.ai.

### Problem: The note says scenarios with ≥70% coverage are selected automatically, but all are selected _(Create)_

- **Why:** In this version every scenario starts selected, whatever its coverage.
- **Fix:** Untick the scenarios you do not want to create before clicking Create.

### Problem: “*n* selected scenario(s) have no steps yet. Press “Generate steps” first, or uncheck them…” / “Please select at least one requirement.” _(Create)_

- **Why:** Create would make empty test cases, or nothing is selected.
- **Fix:** Go [**Back to scenarios**](https://docs.smartestqa.ai/en/analyze-import.html#create), generate steps for those scenarios or untick them, and select at least one requirement.

### Problem: “Save failed.” / “Draft save failed.” _(Create)_

- **Check:** 1. Your licence is active and not at its limit ([see below](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-licence)).
  2. You are still signed in.
- **Fix:** Click [**Save as Draft**](https://docs.smartestqa.ai/en/analyze-import.html#drafts), reload the page and try Create again. Send the time and folder name to info@smartestqa.ai if it fails again.

### Problem: “Pipeline created successfully!” but there is no new pipeline in Schedule _(Create)_

- **Why:** A pipeline needs a Start Page URL. Without one, only the test suite is created and the pipeline is skipped, but the success message still appears.
- **Fix:** Add a [Start Page URL](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url) (mark it default), then [create the pipeline](https://docs.smartestqa.ai/en/schedule-create.html#create) in **Schedule** from the suite named `AI Generated Pipeline - YYYY-MM-DD`.

### Problem: My outline is gone after I switched folders or left the page _(Draft)_

- **Why:** The outline stays on your screen until you save a draft or create. A folder keeps only its saved draft, its preferences and its first file.
- **Fix:** Run [**Analyze with AI**](https://docs.smartestqa.ai/en/analyze-import.html#step-import) again and click [**Save as Draft**](https://docs.smartestqa.ai/en/analyze-import.html#drafts) before you leave. See [Drafts](https://docs.smartestqa.ai/en/analyze-import.html#drafts).

### Problem: The outline is read-only and the buttons are disabled _(Draft)_

- **Why:** It was already created, or the folder has requirements and no draft, so tab 2 lists them read-only.
- **Fix:** Edit created requirements by selecting them in the [tree](https://docs.smartestqa.ai/en/analyze-folders.html#tree). For new ones, run a new analysis.

## Requirements and sub-requirements

### Problem: “Please fill Name and Description” / “Please enter a name” / “Please enter a description” _(Save)_

- **Fix:** Both fields are required on main and sub-requirements. Fill them and save again. See [Fields](https://docs.smartestqa.ai/en/analyze-requirements.html#fields).

### Problem: “Start Date cannot be in the future” / “Start Date cannot be after End Date” / “End Date cannot be before Start Date” / “Invalid date format. Please check your dates” _(Save)_

- **Why:** Start Date must be today or earlier, and not after End Date. For a sub, the message starts with “Sub-requirement *name*:”.
- **Fix:** Correct the date on the main requirement or on the sub named in the message (select it to see its **Detail**), then save.

### Problem: “*name* could not be updated, please try again later” _(Save)_

- **Check:** 1. Your session is still valid (reload in another tab).
  2. Someone else did not [archive](https://docs.smartestqa.ai/en/analyze-folders.html#archive) the requirement meanwhile.
- **Fix:** Copy your text, reload, paste and save again. Write to info@smartestqa.ai with the requirement ID if it persists.

### Problem: **Generate** is greyed out: “Please save the main requirement first” _(AI)_

- **Fix:** Click **Save** on the main requirement, then **Generate**. See [Generate sub-requirements](https://docs.smartestqa.ai/en/analyze-requirements.html#generate-subs).

### Problem: “Requirement description is required” / “No sub requirements generated” / “Failed to analyze requirement” / “Please select at least one sub requirement” _(AI)_

- **Why:** The AI needs the main requirement’s Description, and it may return nothing for a vague one. “Failed to analyze requirement” means the AI call failed (AI off, no key, provider error).
- **Fix:** Write a description with the goal and the rules, save, and run **Analyze** again. Tick at least one proposal before **Add**. For AI errors see [AI disabled](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-ai-disabled) and [AI key](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-ai-key).

### Problem: A sub-requirement disappeared after saving _(Save)_

- **Why:** It was deleted in the list before the save. Removing a sub and saving deletes it for good, with its test case links; it does not go to the Archive.
- **Fix:** Recreate it with **Add** and [link its test cases again](https://docs.smartestqa.ai/en/analyze-test-cases.html#link-existing) (the test cases are still in [Automate](https://docs.smartestqa.ai/en/automate-test-cases.html#find-test-cases)). See [Saving](https://docs.smartestqa.ai/en/analyze-requirements.html#save).

### Problem: “Company license limit has been reached…” / “Your license has expired…” / “Create process failed” _(Licence)_

- **Why:** Your company’s licence can limit how many requirements you create. New requirements and documents count toward that [requirement limit](https://docs.smartestqa.ai/en/company-settings-billing.html), and archived ones still count. An [expired licence](https://docs.smartestqa.ai/en/company-settings-billing.html#licence-status) blocks every create.
- **Fix:** See [limit reached](https://docs.smartestqa.ai/en/quick-start-troubleshooting.html#fix-limit-reached) and [licence expired](https://docs.smartestqa.ai/en/quick-start-troubleshooting.html#fix-license-expired), and ask an Admin to check the licence in [Company Settings › Billing](https://docs.smartestqa.ai/en/company-settings-billing.html). Write main requirements with several subs rather than many separate mains.

### Problem: The text `failToFetchRequirements` appears instead of a message _(Load)_

- **Why:** Loading the requirement tree failed, and the message has no English text yet.
- **Fix:** Reload the page. Check that a project is selected and you [have access to it](https://docs.smartestqa.ai/en/company-settings-users.html#project-access). If it repeats, write to info@smartestqa.ai.

## Test case links and pipelines

### Problem: **Add** is greyed out: “Please select a Sub Requirement first.” / “Please select a Sub Requirement first to delete.” _(Links)_

- **Why:** Test cases link to sub-requirements. With the main requirement selected, the list shows all subs’ test cases read-only.
- **Fix:** Click a sub in [**Sub Requirements**](https://docs.smartestqa.ai/en/analyze-requirements.html#sub-requirements), then use **Add** or **Remove**. A brand-new main needs at least one saved sub first. See [Link a test case](https://docs.smartestqa.ai/en/analyze-test-cases.html#link-existing).

### Problem: “This test case is already added to the Sub Requirement.” _(Links)_

- **Fix:** Nothing to do; each test case is linked once per sub. To change its position, drag it in the list.

### Problem: “Error occurred while removing from Sub Requirement.” / “Failed to fetch Sub Requirement test case list.” _(Links)_

- **Fix:** Save your other changes, reload the page and try again. If a test case was [archived in Automate](https://docs.smartestqa.ai/en/automate-test-cases.html#archive), it no longer appears in the list.

### Problem: **Automate** is greyed out on a sub-requirement _(AI)_

- **Why:** The sub is new (tag **new**) and not saved yet.
- **Fix:** Click **Save** on the main requirement, then **Automate**.

### Problem: “Requirement description is too short” / “Failed to analyze requirement” / “Please select at least one test case” / “Save failed” _(AI)_

- **Why:** The sub’s description must be at least 10 characters; the AI call can fail like any AI request; Create needs at least one ticked test case.
- **Fix:** Write a fuller description (condition and expected result), save, and run **Analyze** again. See [Generate test cases](https://docs.smartestqa.ai/en/analyze-test-cases.html#ai-automate).

### Problem: “Scheduler synchronization failed” / “Some schedulers could not be updated” _(Pipelines)_

- **Why:** The requirement was saved, but updating one or more pipelines failed.
- **Fix:** [Open those pipelines](https://docs.smartestqa.ai/en/schedule.html#pipelines-list) in **Schedule** and check their [parameters](https://docs.smartestqa.ai/en/schedule-settings.html#pipeline-parameters), or change a link and save again to reopen the dialog. See [How links reach pipelines](https://docs.smartestqa.ai/en/analyze-test-cases.html#pipelines).

### Problem: Test Health shows a sub-requirement as not covered although it has a test case _(Coverage)_

- **Why:** [Test Health counts a sub](https://docs.smartestqa.ai/en/insight-numbers.html#pillars) only when a linked scenario checks a result and passed its last run. A test case without an assertion, or one whose last run failed, does not count.
- **Fix:** [Add a check of the result](https://docs.smartestqa.ai/en/automate-steps-assertions.html#choose-a-check) to the test case in Automate and [run it](https://docs.smartestqa.ai/en/schedule-runs.html#run-now) until it passes. See [Test Health formulas](https://docs.smartestqa.ai/en/analyze-numbers.html#test-health-coverage).

## AI assessment

### Problem: **Analyze** is greyed out on Assessment (AI) _(Assessment)_

- **Why:** Either a sub-requirement is selected (“Sub-requirements are analyzed together with the main requirement. Please select the main requirement and click Analyze.”), or there are unsaved changes (“Please save your changes before analyzing with AI”).
- **Fix:** Select the main requirement, click **Save**, then **Analyze**.

### Problem: Dialog “AI Assessment”: “AI Assessment failed: …” _(Assessment)_

- **Why:** The AI call failed. The text after “failed:” gives the reason: AI disabled, no key, a provider error, or an answer the server could not read (“…did not return JSON…”).
- **Fix:** For AI disabled or key errors see [above](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-ai-disabled). Otherwise wait a minute and retry. If the message mentions JSON or a prompt, write to info@smartestqa.ai: it needs a fix on the SmartestQA side.

### Problem: “*n* sub-requirement(s) not yet assessed:” / “Note: *n* sub(s) could not be scored by the LLM.” _(Assessment)_

- **Why:** The AI left those subs out of its answer. Their old score, if any, stays.
- **Fix:** Run **Analyze** again. If the same subs are skipped, make their descriptions clearer and shorter, or split a main requirement with very many subs.

### Problem: The breakdown says “50% weight”, but the Quality Score is not the average of the two bars _(Assessment)_

- **Why:** The Quality Score is the AI’s verdict on the main requirement; the first bar shows the same number and the second the mean of the sub scores, for information only. The “50% weight” wording is outdated.
- **Fix:** Read the Quality Score and the per-sub scores. See [Score Breakdown](https://docs.smartestqa.ai/en/analyze-numbers.html#score-breakdown).

## Tree, folders and archive

### Problem: “Name cannot be empty.” / “Module name is required.” / “A module with this name already exists” _(Folders)_

- **Fix:** Type a name that no other module uses. Module names are shared with [App Map](https://docs.smartestqa.ai/en/discover-app-map.html#modules) and [Automate](https://docs.smartestqa.ai/en/automate-test-cases.html#modules). See [Folders are modules](https://docs.smartestqa.ai/en/analyze-folders.html#modules).

### Problem: A folder I created appeared as a module in App Map and Automate _(Folders)_

- **Why:** A folder directly under the project folder is a module. **Create Folder** with nothing selected creates it there (`new_folder_n`).
- **Fix:** Rename it to a real module name. To turn it into a sub folder instead, an Admin moves it into another module folder, because that removes the module. See [Folders are modules](https://docs.smartestqa.ai/en/analyze-folders.html#modules).

### Problem: “A module folder stays directly under the project root…” / “Only an admin can move a module folder under another module, because it removes the module.” _(Folders)_

- **Why:** Moving a module under another one removes the module from [App Map](https://docs.smartestqa.ai/en/discover-app-map.html#modules) and moves its [Automate folder](https://docs.smartestqa.ai/en/automate-test-cases.html#move). That needs an Admin and a confirmation (“Make *name* a sub folder?”).
- **Fix:** Ask an [Admin](https://docs.smartestqa.ai/en/company-settings-roles.html#matrix) to do the move, or move the module’s requirements instead of the folder.

### Problem: “This module can’t be deleted yet: its folders still hold *n* item(s) in Analyze and *m* in Automate…” / “A module folder is deleted together with its module…” _(Folders)_

- **Why:** A module folder is removed together with its module, and a direct delete is refused while its folders hold items.
- **Fix:** As an Admin, archive the module folder from the tree (row menu › **Delete**): the module and its contents move to the Archive together. Or move the items out first. See [Archive](https://docs.smartestqa.ai/en/analyze-folders.html#archive).

### Problem: “You can only archive what you created…” / “Only an admin can archive a module…” / “You are not authorized to delete. Only admin or the creator can delete this.” _(Archive)_

- **Why:** Users can archive only items where they created everything inside; modules need an Admin. The dialog’s **Created by** line shows who created what.
- **Fix:** Ask an [Admin](https://docs.smartestqa.ai/en/company-settings-roles.html#matrix) or the creator. See [Who can do what](https://docs.smartestqa.ai/en/analyze-folders.html#who-can).

### Problem: “Used as a template step in other test cases. Remove those steps first:” _(Archive)_

- **Why:** Archiving a module also archives its Automate folder, and a test case in it is called as a [template step](https://docs.smartestqa.ai/en/automate-steps-flow.html#template) by other test cases.
- **Fix:** [Open the listed test cases in Automate](https://docs.smartestqa.ai/en/automate-editor.html#editor-screen) and [remove](https://docs.smartestqa.ai/en/automate-editor.html#remove-step) or [replace](https://docs.smartestqa.ai/en/automate-editor.html#replace-action) those steps, then archive again.

### Problem: “Only the person who archived it or an admin can restore it.” _(Archive)_

- **Fix:** Ask the person who archived it, or an Admin, to click **Restore**. After restoring, [add the requirement to its pipelines again](https://docs.smartestqa.ai/en/schedule-create.html#add-content): restoring does not do that.

### Problem: “Archiving failed.” / “Move failed” / “Delete failed.” / “Requirement update failed” / “Saving failed. Please try again.” _(Tree)_

- **Fix:** Read the reason after the message if there is one (module rules are explained above). Otherwise reload the page and try again.

### Problem: Search does not find a sub-requirement, or the Severity filter hides my documents _(Tree)_

- **Why:** The tree contains main requirements, folders and documents only, so it searches their names and IDs. Documents have no severity.
- **Fix:** Search for the main requirement, or for the sub’s ID. Clear the Severity filter to see documents. See [Find requirements](https://docs.smartestqa.ai/en/analyze-folders.html#filter).

## Documents and comments

### Problem: “This folder holds project documents only…” / “Requirements cannot be created inside the Documents folder.” / “Items cannot be moved in or out of the Documents folder.” / “This item can’t be archived.” _(Documents)_

- **Why:** Documents is a special folder for files only. See [Rules of the Documents folder](https://docs.smartestqa.ai/en/analyze-folders.html#documents-rules).
- **Fix:** Select a requirement folder for requirements and the AI wizard. Inside Documents you can still create sub folders and documents to organise files.

### Problem: “*name* appears to be a corrupted or placeholder file (not a real .docx)…” / “Failed to create document. Please try again.” _(Documents)_

- **Why:** The file has a .docx name but is not a Word file (often a web page saved as .docx), or the cached copy of the file is incomplete.
- **Fix:** Open the original in Word, save it again as .docx, and attach that file. If the message mentions the cached content, select the file from your computer again.

### Problem: “This file cannot be displayed as text. Please download to view.” / “Could not extract DOCX content” / “Download failed: Missing file data” _(Documents)_

- **Fix:** Use **Download File** to open it locally. For a Word file, try **Extract Text** in Edit mode once more. A document created empty has no file to download.

### Problem: “Comment cannot be empty” / “Couldn't load comments. Please try again.” / “Error creating comment” / I can’t edit someone’s comment _(Comments)_

- **Fix:** Type some text before **Send**; use **Retry** to reload. You can edit or delete only your own comments. See [Comments](https://docs.smartestqa.ai/en/analyze-requirements.html#comments).
