# Troubleshooting

Fixes for the most common problems with Apifolio.

**"The file … is no longer attached to this page."**
The attachment was renamed or deleted. Attach the file again with the same name, or edit the macro and pick the new file.

**"This YAML file is not valid" with a line number.**
The spec has a syntax error. Open the file, go to the line shown and fix it (often a tab instead of spaces, or a missing quote). The preview in the macro configuration shows the error while you edit.

**"This file is not an OpenAPI or Swagger document."**
The file has no `openapi` or `swagger` field at the top. Check that you picked the right file.

**"You don't have permission to see…"**
The spec is attached to another page you can't view. Ask the page owner for access, or attach a copy of the spec to this page.

**The docs show an old version.**
Reload the page. Apifolio caches the parsed spec while the page is open, and always loads the latest attachment version on a fresh load.

**Search in Confluence doesn't find new endpoints.**
Open the macro configuration and click **Save** to refresh the [search digest](/docs/confluence-search/).

**The PDF shows only tables of endpoints.**
The API has more than 250 endpoints after filters. Narrow the macro to fewer sections. See [Export](/docs/export/).

**Anonymous visitors see an error.**
The spec must be attached to the same page and be smaller than 4 MB. See [Public spaces](/docs/public-and-anonymous/).

Still stuck? Write to [support@apifolio.dev](mailto:support@apifolio.dev) with the page link and a screenshot.