Technical Issues

FAQ about technical problems and solutions

Last updated: 2026-11-13

Technical Issues FAQ

Troubleshooting common technical problems on HoldOrange. If your issue isn't covered here, contact our support team.


The page won't load, what should I do?

If HoldOrange pages are failing to load or displaying blank screens, work through these steps:

1. Check your internet connection

  • Visit another website to confirm your connection is active.
  • If you're on Wi-Fi, try switching to a wired connection or mobile data temporarily.

2. Check the platform status

  • Visit our Status Page to see if there's an ongoing outage or maintenance window.

3. Try a hard refresh

  • macOS: Press Cmd + Shift + R
  • Windows / Linux: Press Ctrl + Shift + R
  • This bypasses the browser cache and forces a fresh page load.

4. Disable browser extensions

  • Ad blockers, privacy extensions, and VPNs can interfere with the platform. Try loading the page in an incognito/private window to rule out extension conflicts.

5. Clear browser cache and cookies

💡Tip
If the page loads in incognito mode but not in your regular browser, the issue is almost certainly caused by a browser extension or cached data. Re-enable extensions one at a time to identify the culprit.

6. Try a different browser

  • If the issue persists, try Chrome, Firefox, or Edge to determine if it's browser-specific.

I can't upload files

File upload issues can have several causes. Here's how to diagnose and fix them:

Check file requirements:

  • Supported formats: JPG, JPEG, PNG, WebP, GIF (images); MP4, MOV, WebM (video); MP3, WAV, FLAC (audio)
  • Maximum file size: 10 MB for images, 500 MB for video, 50 MB for audio
  • Minimum resolution: 128 × 128 pixels for images

Common upload problems and solutions:

ProblemSolution
Upload button is greyed outCheck that you're logged in and have an active session
Upload starts but never completesCheck your connection speed; large files need stable bandwidth
"File type not supported" errorConvert your file to a supported format (e.g., use PNG instead of TIFF)
"File too large" errorCompress or resize the file before uploading
Upload fails with no errorDisable your ad blocker — it may be blocking upload requests
💡Tip
For batch uploads, use the drag-and-drop zone rather than the file picker dialog. You can drop up to 20 files at once. If batch uploads fail, try uploading files individually to identify which specific file is causing the issue.

Network-related upload failures:

  • Corporate firewalls or proxy servers may block large file uploads. Contact your IT team to whitelist *.holdorange.com domains.
  • If you're on a slow connection, uploads may time out. The platform will automatically retry up to 3 times before reporting failure.

Browser compatibility issues

HoldOrange is optimized for modern browsers. Here are the supported browsers and known issues:

Fully supported browsers: | Browser | Minimum Version | Notes | |---------|----------------|-------| | Google Chrome | 100+ | Recommended for best experience | | Mozilla Firefox | 100+ | Fully supported | | Microsoft Edge | 100+ | Chromium-based, fully supported | | Safari | 16+ | Supported with minor limitations |

Known limitations:

  • Safari: WebGL-based canvas features may have reduced performance. The canvas editor works best in Chrome or Edge.
  • Firefox: Hardware-accelerated video preview may be disabled by default. Enable it in about:config → media.hardware-video-decoding.enabled.
  • Mobile browsers: The platform is responsive but optimized for desktop. Some advanced editing features (canvas editor, batch operations) may not be available on mobile.
💡Tip
Always keep your browser updated to the latest version. HoldOrange uses modern web APIs (WebGL 2.0, WebAssembly, Web Workers) that require recent browser versions for optimal performance. You can check your browser version by navigating to chrome://version (Chrome) or about:support (Firefox).

If you're experiencing rendering issues:

  1. Ensure hardware acceleration is enabled in your browser settings.
  2. Update your GPU drivers to the latest version.
  3. Try disabling any custom CSS or user-style browser extensions.

My downloads are failing

If you're unable to download generated content, try the following:

1. Check your browser's download settings

  • Ensure your browser isn't set to block pop-ups or downloads from holdorange.com.
  • Check your default download directory — it may be full or permissions may have changed.

2. Try right-click → "Save As"

  • Instead of the download button, right-click the content and select "Save image as..." or "Save link as...". This uses the browser's native download handler and bypasses any platform-level issues.

3. Check download file size

  • High-resolution images and video files can be large. Ensure you have sufficient disk space.
  • Video downloads in 4K can exceed 200 MB — make sure your connection is stable.

4. Disable download managers

  • Third-party download manager extensions can conflict with the platform's download mechanism. Temporarily disable them and retry.
💡Tip
Use the Batch Download feature in your Gallery to download multiple files as a ZIP archive. This is faster and more reliable than downloading files individually, especially for large projects. Select the files you want, then click Download Selected → As ZIP.

5. API downloads

  • If you're using the API, ensure your authentication token hasn't expired. Refresh your token and retry the download request.
  • Download URLs are temporary (valid for 1 hour). Request a fresh URL if your previous link has expired.

The canvas editor is lagging

The canvas editor uses WebGL for real-time rendering and can be resource-intensive. Here's how to improve performance:

Quick fixes:

  1. Close unnecessary browser tabs: Each tab consumes memory. Close tabs you don't need.
  2. Reduce canvas zoom level: Working at very high zoom levels increases the rendering load.
  3. Disable real-time preview: In editor settings, toggle off "Real-time Preview" to only render on demand.
  4. Lower the canvas resolution: Work at a lower resolution during editing, then upscale the final output.

System requirements for optimal canvas performance: | Component | Minimum | Recommended | |-----------|---------|-------------| | RAM | 4 GB | 8 GB or more | | GPU | Integrated graphics | Dedicated GPU (2 GB+ VRAM) | | Browser | Chrome 100+ | Chrome latest stable | | Display | 1080p | 1440p or higher |

💡Tip
Enable Performance Mode in the canvas editor settings (gear icon → Performance). This reduces visual effects and preview quality during editing for smoother interactions, then renders at full quality on export.

Advanced troubleshooting:

  • Check if hardware acceleration is enabled: Chrome → Settings → System → "Use hardware acceleration when available"
  • Open the browser's Task Manager (Shift + Esc in Chrome) to see if the tab is consuming excessive memory
  • If GPU-related crashes occur, try updating your graphics drivers or switching to software rendering mode in the editor settings

Why can't I see my generated content?

If your generations appear to be missing from your history or gallery:

1. Check the correct workspace

  • If you belong to multiple teams or workspaces, ensure you're viewing the correct one. Use the workspace switcher in the top-left corner.

2. Check filters and sorting

  • The Generation History panel has filters for date range, status, and content type. Reset all filters by clicking Clear Filters to see everything.

3. Check the generation status

  • Your content may still be processing. Look for items with a "Pending" or "In Progress" status badge.
  • Failed generations are hidden by default. Toggle "Show Failed" in the filter options to view them.

4. Account sync issues

  • If you're logged in on multiple devices, try logging out and back in to force a data sync.
  • Your browser may be showing cached/stale data. Hard-refresh the page (Cmd + Shift + R / Ctrl + Shift + R).
💡Tip
Use the Search function in your Generation History to find specific content. You can search by prompt text, date, model name, or generation ID. If you saved a generation to a specific project folder, check that folder directly from the Projects panel.

5. Storage retention

  • Free-tier accounts retain generated content for 30 days. After that, content is automatically deleted.
  • Paid accounts have extended retention (90 days for Basic, 1 year for Pro, unlimited for Enterprise).
  • Download important content promptly or upgrade your plan for extended storage.

Audio/video playback issues

If audio or video content won't play or plays incorrectly:

Common symptoms and solutions:

SymptomLikely CauseSolution
No audioBrowser muted or audio output misconfiguredCheck browser tab mute status and system audio settings
Video shows black screenHardware acceleration conflictDisable hardware acceleration temporarily
Playback stutteringSlow network or insufficient bandwidthWait for the content to buffer, or download and play locally
"Format not supported"Outdated browserUpdate your browser to the latest version
Audio/video out of syncBrowser rendering issueTry a different browser or download the file

Browser media playback checklist:

  1. Ensure the browser tab isn't muted (look for a speaker icon in the tab).
  2. Check your system volume and audio output device.
  3. Try clicking directly on the video player — some browsers require user interaction before allowing media playback.
  4. Check that no other application is exclusively holding the audio device.
💡Tip
For the most reliable playback experience, download the generated video/audio file and play it with a dedicated media player like VLC. Browser-based playback can be affected by codec support, DRM, and browser-specific quirks.

Codec support:

  • HoldOrange generates video in H.264 (MP4) and WebM formats, which are widely supported.
  • Audio is generated in MP3 and WAV formats.
  • If your browser can't play a specific format, use the Download button and convert using a tool like FFmpeg or HandBrake.

How to clear cache and fix display issues

Clearing your browser cache resolves many display problems including broken layouts, missing images, and stale data.

Google Chrome:

  1. Press Cmd + Shift + Delete (macOS) or Ctrl + Shift + Delete (Windows/Linux).
  2. Set the time range to All time.
  3. Check Cached images and files and Cookies and other site data.
  4. Click Delete data.
  5. Close and reopen Chrome, then navigate back to HoldOrange.

Mozilla Firefox:

  1. Press Cmd + Shift + Delete (macOS) or Ctrl + Shift + Delete (Windows/Linux).
  2. Set the time range to Everything.
  3. Check Cache and Cookies.
  4. Click Clear Now.

Safari:

  1. Go to Safari → Settings → Privacy → Manage Website Data.
  2. Search for "holdorange" and remove related entries.
  3. Alternatively, go to Develop → Empty Caches.

Microsoft Edge:

  1. Press Cmd + Shift + Delete (macOS) or Ctrl + Shift + Delete (Windows/Linux).
  2. Check Cached images and files and Cookies and other site data.
  3. Click Clear now.
💡Tip
If you don't want to clear all site data, you can clear only HoldOrange's cache: open DevTools (F12), go to the Application tab, and under Storage, click Clear site data. This removes only data for the current site while preserving your other browsing data.

After clearing the cache, you'll need to log in again. Make sure you have your credentials ready.


API rate limiting

If you're integrating with the HoldOrange API and receiving 429 Too Many Requests errors, you've hit the rate limit.

Rate limits by plan:

PlanRequests/minuteRequests/hourConcurrent Generations
Free101001
Basic305002
Pro602,0005
Enterprise200+10,000+10+

How to handle rate limiting:

  1. Implement exponential backoff: When you receive a 429 response, wait before retrying. Start with 1 second, then double the wait time on each subsequent retry (1s → 2s → 4s → 8s), up to a maximum of 60 seconds.
  1. Check response headers: Every API response includes rate limit headers:
   X-RateLimit-Limit: 60
   X-RateLimit-Remaining: 45
   X-RateLimit-Reset: 1708819200

Use X-RateLimit-Remaining to proactively slow down before hitting the limit.

  1. Use webhooks instead of polling: For generation status, register a webhook callback URL instead of repeatedly polling the status endpoint. This dramatically reduces your API call count.
  1. Batch requests: Use the batch endpoint (POST /api/v1/generations/batch) to submit multiple generations in a single request instead of making individual calls.
💡Tip
If you consistently need higher rate limits, contact our sales team about Enterprise plans with custom rate limit configurations. For temporary burst capacity (e.g., during a product launch), we can provide temporary limit increases — submit a request at least 48 hours in advance via the support portal.

Example: Implementing retry with exponential backoff (Python):

import time
import requests

def generate_with_retry(prompt, max_retries=5):
    for attempt in range(max_retries):
        response = requests.post(
            "https://api.holdorange.com/v1/generations",
            json={"prompt": prompt},
            headers={"Authorization": "Bearer YOUR_TOKEN"}
        )
        if response.status_code == 429:
            wait_time = min(2 ** attempt, 60)
            print(f"Rate limited. Waiting {wait_time}s...")
            time.sleep(wait_time)
            continue
        response.raise_for_status()
        return response.json()
    raise Exception("Max retries exceeded")

Before integrating, confirm API availability, applicable API documentation, and authentication requirements for your deployment with platform support.