--- title: Troubleshooting slug: docs/documentation-new/troubleshooting description: new, from upload problems to AI inaccuracies and more—get support today! createdAt: 2025-04-08T06:39:28.590Z --- Welcome to the **Troubleshooting Guide** for Documentation.new. Here, we’ve gathered some common pain points and quick solutions to help you resolve any issues you might encounter while using the platform. If you're experiencing challenges, don’t worry! This guide will walk you through some of the most frequently asked questions and provide actionable steps to fix them. *** :::ExpandableHeading{isOpen="true"} ## Issue: My Documentation Isn’t Generating Correctly ### Possible Causes: - Incorrect file format or unsupported link type. - AI not able to parse the content properly. ### Solution: 1. **Check Input Format**: Ensure your file is in one of the supported formats (.md, .txt, .docx, .json, .yaml, .yml, .zip) and is under the 10MB limit. 2. **Use Clear Descriptions**: If using a website link or prompt, make sure it’s well-structured and provides enough context for the AI to understand. 3. **Try Re-generating**: Click on the **"Generate"** button again to see if the AI produces a better draft based on your input. ::: *** :::ExpandableHeading ## Issue: I Can’t Upload My Document ### Possible Causes: - File size exceeds the 10MB limit. - Unsupported file format. ### Solution: 1. **Check File Size**: Ensure the document is under 10MB. 2. **Supported Formats**: Make sure you’re uploading a supported file format (Markdown, DOCX, JSON, etc.). If your file is zipped, ensure it’s a supported file inside. 3. **Re-upload**: Try uploading the document again to see if the issue persists. ::: *** :::ExpandableHeading ## Issue: The AI Draft Doesn’t Reflect My Product Properly ### Possible Causes: - Lack of detailed input. - The AI may not fully understand the context of your product. ### Solution: 1. **Provide More Detail**: Try to input a detailed description of your product or feature in the prompt. 2. **Check Your Source Links**: If you provided a website link, ensure that the page is not too generic. A product page or feature list is more helpful. 3. **Contact Support**: If the AI still struggles, contact our support team to help fine-tune the AI’s understanding. ::: *** :::ExpandableHeading ## Issue: I Can’t Edit My Documentation in Archbee ### Possible Causes: - You haven’t connected the editor properly. - Permissions are not set correctly. ### Solution: 1. **Ensure Correct Integration**: After generating your draft, click **"Edit in Archbee"** to open the full Archbee editor. 2. **Check Permissions**: Ensure that you have the right permissions in your workspace. Admins and Editors have access to editing, while Viewers do not. 3. **Recheck Your Account**: If you’re still having issues, log out and log back in to ensure your session is active. ::: *** :::ExpandableHeading ## Issue: I Can’t Edit My Documentation in Archbee ### Possible Causes: - You haven’t connected the editor properly. - Permissions are not set correctly. ### Solution: 1. **Ensure Correct Integration**: After generating your draft, click **"Edit in Archbee"** to open the full Archbee editor. 2. **Check Permissions**: Ensure that you have the right permissions in your workspace. Admins and Editors have access to editing, while Viewers do not. 3. **Recheck Your Account**: If you’re still having issues, log out and log back in to ensure your session is active. ::: *** :::ExpandableHeading ## Issue: My Documentation Looks Different After Publishing ### Possible Causes: - Custom domain or branding not set up. - Formatting issues after editing in Archbee. ### Solution: 1. **Set Your Branding**: Go to **Workspace > Branding Settings** to ensure your custom logo, color scheme, and domain are correctly applied. 2. **Check for Formatting Issues**: Review the documentation in the preview mode before publishing. Adjust layout and formatting if needed. 3. **Test Custom Domain**: If using a custom domain, ensure DNS propagation is complete and the setup is correct. ::: *** :::ExpandableHeading ## Issue: I Can’t Find My Documentation After Publishing ### Possible Causes: - Incorrect visibility settings. - Custom domain or subdomain not linked properly. ### Solution: 1. **Check Visibility Settings**: Ensure that your documentation is set to **Public** if you want it to be accessible to anyone. 2. **Check Domain Setup**: If using a custom domain, double-check the DNS settings in **Settings > Custom Domain**. 3. **Search for Your Doc**: Use the search function within Archbee to find your document, or check the direct link shared during publishing. ::: *** ## 💬 Still Having Trouble? If you’ve gone through the troubleshooting steps and are still facing issues, don’t hesitate to reach out to our support team. - Send your question to [support@archbee.com](mailto\:support@archbee.com) We’re here to help you make the most of Documentation.new! Let me know if you need any changes or additions!