Documentation
SiteDocs
Troubleshooting

Troubleshooting

Generation Fails with API Error

Verify your API key

Confirm your API key is valid and has sufficient credits.

Check server connectivity

Check whether your server can reach the AI provider API (no outgoing firewall blocks).

Reduce scope

Reduce the number of sections being generated at once - complex sites may timeout.


Scan Shows No Custom Post Types

Check CPT registration priority

Confirm CPTs are registered at init with priority ≤ 10 - SiteDocs scans at priority 20.

Confirm the plugin is active

If using a plugin to register CPTs, confirm the plugin is active.


PDF Export Empty or Broken

Check PHP memory limit

Ensure the server's PHP memory limit is at least 128MB.

Check write permissions

Verify that the server can write to the uploads directory (used for temporary PDF files).

Reduce sections

Try generating with fewer sections by temporarily clearing some sections first.


Dashboard Widget Not Showing

Check the setting

Confirm Show Dashboard Widget is enabled in settings.

Check your role

Verify that your user role is included in Role Visibility.

Check screen options

Screen Options at the top of the dashboard may have the widget unchecked - click Screen Options and enable it.