> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tomake.design/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common issues and solutions for html.tomake.design

## Installation issues

### Plugin not appearing in Figma

<AccordionGroup>
  <Accordion title="Solution 1: Refresh Figma" icon="rotate">
    1. Close all Figma tabs/windows
    2. Reopen Figma
    3. Navigate to **Plugins** menu
    4. Look for html.tomake.design
  </Accordion>

  <Accordion title="Solution 2: Reinstall plugin" icon="download">
    1. Visit [Figma Community](https://www.figma.com/community/plugin/1557932447766289380)
    2. Click **Install** again
    3. Restart Figma
    4. Check **Plugins** menu
  </Accordion>

  <Accordion title="Solution 3: Check permissions" icon="shield">
    1. Go to **Settings** → **Plugins**
    2. Ensure plugins are enabled
    3. Check if html.tomake.design has necessary permissions
  </Accordion>
</AccordionGroup>

### Browser extension not installing

<AccordionGroup>
  <Accordion title="Chrome/Edge installation issues" icon="chrome">
    1. Ensure you're using latest Chrome or Edge version
    2. Check Extensions page: `chrome://extensions`
    3. Enable "Developer mode" if needed
    4. Install from [Chrome Web Store](https://chromewebstore.google.com/detail/htmltofigdesign/ijoegnplinjhfdnhgakjgfejieiclppi)
    5. Refresh browser after installation
  </Accordion>
</AccordionGroup>

## Capture issues

### Page won't open in browser

**Symptoms**: Clicking "Open in Browser" does nothing or shows an error.

<Steps>
  <Step title="Check popup blocker">
    Disable popup blockers for Figma in your browser settings
  </Step>

  <Step title="Allow permissions">
    Grant browser permissions when prompted by the plugin
  </Step>

  <Step title="Try different browser">
    Use Chrome or Edge for best compatibility
  </Step>

  <Step title="Check URL validity">
    Ensure the URL is correct and accessible (try opening it manually first)
  </Step>
</Steps>

### Capture button not working

**Symptoms**: Clicking capture button doesn't start the conversion.

<AccordionGroup>
  <Accordion title="Install browser extension" icon="puzzle-piece">
    The Chrome extension is required for capture functionality:

    1. Install from [Chrome Web Store](https://chromewebstore.google.com/detail/htmltofigdesign/ijoegnplinjhfdnhgakjgfejieiclppi)
    2. Reload the webpage
    3. Try capture again
  </Accordion>

  <Accordion title="Check extension permissions" icon="lock">
    1. Click extension icon in browser
    2. Grant all requested permissions
    3. Reload the page
    4. Try capture again
  </Accordion>

  <Accordion title="Clear browser cache" icon="trash">
    1. Clear browser cache and cookies
    2. Reload the page
    3. Wait for full page load
    4. Try capture again
  </Accordion>
</AccordionGroup>

### Capture stuck or freezing

**Symptoms**: Capture starts but doesn't complete or shows loading indefinitely.

<Warning>
  This usually happens with very complex pages or slow websites.
</Warning>

**Solutions**:

1. **Wait longer**: Complex pages can take 30-60 seconds
2. **Refresh and retry**: Reload the page and try again
3. **Capture specific section**: Instead of full page, capture a section
4. **Check internet connection**: Ensure stable connection
5. **Try simpler viewport**: Start with mobile view if desktop is too complex

### Partial page capture

**Symptoms**: Only part of the page is captured.

<Steps>
  <Step title="Enable full page capture">
    Check "Full page" option in plugin settings before opening browser
  </Step>

  <Step title="Wait for page load">
    Ensure entire page is loaded before clicking capture
  </Step>

  <Step title="Scroll through page">
    Manually scroll to bottom to trigger lazy-loaded content
  </Step>

  <Step title="Increase timeout">
    For slow-loading pages, wait 5-10 seconds after load before capturing
  </Step>
</Steps>

## Quality issues

### Blurry or low-quality images

**Symptoms**: Imported images look pixelated or low resolution.

**Causes & Solutions**:

* **Source images are low quality**: The plugin captures images at their source resolution. Check if the website serves low-res images.
* **Retina/high-DPI capture**: Try capturing at desktop viewport for higher resolution
* **Image compression**: Some websites serve compressed images that may look blurry when zoomed in Figma

### Missing text or text as images

**Symptoms**: Text doesn't appear or is captured as images instead of editable text.

<AccordionGroup>
  <Accordion title="Icon fonts" icon="icons">
    Icon fonts may capture as images. This is normal. Extract icons separately if needed.
  </Accordion>

  <Accordion title="Custom fonts not loading" icon="font">
    1. Ensure fonts are loaded on the page before capture
    2. Wait a few extra seconds after page load
    3. Scroll through page to trigger font loading
  </Accordion>

  <Accordion title="Text in images" icon="image">
    Text that's part of images (not HTML text) will import as images. This is expected behavior.
  </Accordion>
</AccordionGroup>

### Wrong colors or styling

**Symptoms**: Colors don't match the original website.

**Common causes**:

1. **Theme mismatch**: Ensure you selected correct theme (light/dark)
2. **Dynamic styles**: Some sites change colors based on user interaction
3. **Browser rendering**: Try different browser for capture
4. **Color profiles**: Check if your Figma color profile matches web standards

### Layout issues

**Symptoms**: Elements are misaligned or overlapping incorrectly.

**Solutions**:

* **Responsive design**: Website may shift elements. Try different viewport size.
* **JavaScript timing**: Wait for all JS to execute before capturing
* **Sticky elements**: Headers/footers may capture in wrong position. Scroll to reset.
* **Complex positioning**: Some CSS positioning may need manual adjustment in Figma

## Authentication issues

### Can't capture logged-in pages

**Symptoms**: Page shows login screen instead of authenticated content.

<Steps>
  <Step title="Install browser extension">
    The extension maintains your login session during capture
  </Step>

  <Step title="Log in first">
    1. Open URL in plugin
    2. Browser tab opens
    3. Log in to the website
    4. Navigate to desired page
    5. Click capture button
  </Step>

  <Step title="Check session timeout">
    If session expires, log in again before capturing
  </Step>
</Steps>

### Session expires during capture

**Solutions**:

1. Complete capture quickly after login
2. Increase session timeout in website settings if possible
3. Have credentials ready to quickly re-login
4. Contact support for enterprise/long-session solutions

## Error messages

### "Failed to capture page"

**Possible causes**:

* Website blocks automated tools (Captcha, bot protection)
* Invalid or inaccessible URL
* Network connectivity issues
* Browser extension not installed or outdated

**Solutions**:

1. Verify URL is accessible in normal browser
2. Install/update browser extension
3. Check internet connection
4. Try again in a few minutes
5. Contact support if issue persists

### "Import limit reached"

**Cause**: You've exceeded your plan's monthly import limit.

**Solutions**:

* Wait until next month for limit reset
* Upgrade to Pro plan for unlimited imports
* Contact support for enterprise options

### "File too large"

**Cause**: The resulting Figma file exceeds size limits.

**Solutions**:

1. Capture specific sections instead of full page
2. Use smaller viewport (mobile instead of desktop)
3. Disable full-page capture
4. Simplify the target page if possible

## Performance issues

### Plugin running slow

<AccordionGroup>
  <Accordion title="Close other plugins" icon="xmark">
    Close other Figma plugins that may be running in background
  </Accordion>

  <Accordion title="Restart Figma" icon="rotate">
    Close and reopen Figma to refresh performance
  </Accordion>

  <Accordion title="Clear Figma cache" icon="broom">
    1. Close Figma
    2. Clear application cache
    3. Restart Figma
  </Accordion>

  <Accordion title="Check system resources" icon="memory">
    Ensure your computer has available memory and isn't running too many applications
  </Accordion>
</AccordionGroup>

### Browser tab crashes during capture

**Solutions**:

1. Close other browser tabs to free memory
2. Restart browser
3. Try capturing smaller sections
4. Use desktop viewport instead of capturing full page
5. Update browser to latest version

## Website-specific issues

### Website blocks capture

**Symptoms**: Error message about blocked access or Captcha appears.

<Note>
  Some websites have security measures that prevent automated capture.
</Note>

**What you can try**:

1. Capture the page manually (screenshot) then import image to Figma
2. Check if website has public API for design assets
3. Contact website owner for permission
4. Use alternative similar pages for reference

### Dynamic content not captured

**Symptoms**: Dropdown menus, modals, or tooltips don't appear in capture.

**Solutions**:

1. Trigger the element before capturing (click to open dropdown)
2. Use browser extension for better interaction support
3. Capture multiple states separately (closed and open states)
4. Manually recreate dynamic elements in Figma after import

### Infinite scroll pages

**Symptoms**: Only first section of infinite scroll captures.

**Workaround**:

1. Scroll to load desired content before capturing
2. Capture in sections
3. Use "Full page" option and scroll to trigger all content
4. Some infinite scroll pages may need manual compilation

## Still need help?

<CardGroup cols={3}>
  <Card title="Discord community" icon="discord" href="https://discord.com/invite/VVArNqBGjB">
    Ask the community for help
  </Card>

  <Card title="Email support" icon="envelope" href="mailto:support@tomake.design">
    Contact support team
  </Card>

  <Card title="Report bug" icon="bug" href="https://github.com/tomakedesign">
    File a bug report
  </Card>
</CardGroup>

## Before contacting support

Help us help you faster by including:

* URL you're trying to capture
* Browser and version
* Figma version (desktop/web)
* Error messages or screenshots
* Steps to reproduce the issue
* What you've already tried

<Tip>
  Check our [Discord community](https://discord.com/invite/VVArNqBGjB) first — someone may have already solved your issue!
</Tip>