---
title: Build Failures
description: Match your build error to a fix -- config mistakes, MDX syntax errors, missing files, OpenAPI issues, and timeouts.
---

Open the failed build in your Deployments tab and match the error message to a section below.

## Finding the Error

1. Go to your project's **Deployments** tab
2. Click the failed build
3. Review the error message and log

The log shows exactly what went wrong and where.

## Common Failures

### Invalid Configuration

**Error:** "Invalid docs.json"

Your `docs.json` has syntax or schema errors.

**Fix:**
1. Check for missing commas, brackets, or quotes
2. Run `jamdesk validate` locally
3. Compare against the [schema reference](/config/docs-json-reference)

### Missing Pages

**Error:** "Page 'path/to/page' not found"

A page in navigation doesn't exist.

**Fix:**
- Verify the file exists
- Check the path matches exactly (case-sensitive)
- Don't include `.mdx` extension in `docs.json`

### MDX Syntax Errors

**Error:** "MDX compilation failed"

Invalid MDX or JSX syntax.

**Common causes:**
- Unclosed tags: `<Card>` without `</Card>`
- Unescaped braces: `{` instead of `\{`
- Invalid props: `title=value` instead of `title="value"`

### Missing Images

**Error:** "Asset not found"

An image referenced in MDX doesn't exist.

**Fix:**
- Check the image path is correct
- Paths are relative to your docs directory
- Verify the file was committed to Git

## Debugging Steps

<Steps>
  <Step title="Read the error">
    The log tells you exactly what failed and where.
  </Step>
  <Step title="Test locally">
    Run `jamdesk dev` to reproduce the error.
  </Step>
  <Step title="Validate config">
    Run `jamdesk validate` to check your configuration.
  </Step>
  <Step title="Check recent changes">
    Review your last commit for the issue.
  </Step>
</Steps>

## Still Stuck?

If you can't resolve the issue:

1. Copy the full build log
2. Note your project ID
3. [Contact support](/help/support/contact)

## Related Articles

<Columns cols={2}>
  <Card title="Error Reference" icon="book" href="/help/troubleshooting/error-reference">
    All error codes explained
  </Card>
  <Card title="CLI Overview" icon="terminal" href="/cli/overview">
    Test builds locally
  </Card>
</Columns>