> For the complete documentation index, see [llms.txt](https://help.metaforms.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.metaforms.ai/survey-programming-dimensions/change-management/troubleshooting.md). # Troubleshooting Use this guide when you cannot start Change Management, a change is missing or unclear, a question is blocked, or you cannot finish the version. ## I cannot start a new version Confirm that the project already has its current questionnaire loaded and that you selected **Upload New Version** from that project. Check that the revised questionnaire is included in the upload. If the project is a tracker, confirm whether it is truly a new wave before selecting the new-wave option. ## The expected change was not detected First, confirm that the revised file was uploaded and that the intended change is visible in it. Metaforms identifies changes most reliably when the questionnaire uses tracked changes or highlights. Add a clarification to describe the missing update, then ask the Change Management agent to create the change. Review the resulting preview before accepting it. ## The detected change is wrong or incomplete Do not accept it. Use the agent to explain what should change and reference the relevant question or questions with `@`. Include the intended wording, answer options, routing, or quota impact. Preview the revised proposal, then accept it only when it matches the questionnaire. ## A question is blocked by a clarification Open the linked clarification, add the missing answer or context, and select **Check Resolution** on the blocked question. The agent will re-evaluate the change. If it remains blocked, make the clarification more specific—for example, state which question, option, or routing outcome is intended. ## I cannot see **Finish CM** Every checklist item must be applied or marked **Done** before **Finish CM** appears. Check the checklist for incomplete or blocked questions, resolve any linked clarifications, and retry the item. Finish only after reviewing all accepted previews and completing your normal QA. ## I uploaded the wrong or outdated file Before proceeding, review the files carried into the new version. Files not removed during upload carry forward from the earlier version. If an outdated file affects the detected changes, do not rely on the current results; correct the version inputs before applying changes. ## Still need help? Share the project and version name, the affected question ID, the clarification text or checklist status, and a screenshot of the preview or error. This gives the support team enough context to reproduce the issue. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.metaforms.ai/survey-programming-dimensions/change-management/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.