1. Home
  2. Knowledge Base
  3. Document Library Pro
  4. Troubleshooting

My document library isn't loading properly

There are several possible reasons why the table may not load in Document Library Pro.

I can see a [doc_library] shortcode on the page but it’s not displaying a table

If the shortcode is appearing on the page but isn’t showing a table then there’s almost certainly a problem with your license key. The table will only load when you have a valid and active license key.

Go to the plugin settings page and check whether your license key is successfully activated. See our article on license key problems.

If your license key is active then there may be an error with your shortcode. Check the syntax of your shortcode carefully against the documentation in the Getting Started section. Minor syntax errors (e.g. extra spaces, extra commas or missing colons) can cause problems.

I can just see a blank page

If you’re getting a blank page instead of a table then this is probably caused by one of these issues:

  1. Too many posts – If you have 100’s or 1,000’s of posts then this can cause performance issues and the table may not load. Try activating lazy load by adding lazy_load=”true” to the Document Library Pro shortcode. This will load one page of posts at a time, reducing the server load.
  2. Are there a JavaScript/AJAX errors in your theme? – The table sometimes fails to load due to JavaScript or AJAX errors in the theme. You can test this by switching to a different theme (e.g. TwentySeventeen) and seeing whether the table loads. If the table loads ok in another theme then you will need to troubleshoot these issues in your theme. If the table doesn’t load when you switch themes, please submit a support request.

The table is loading but there are no posts/data in it

If you’re getting an empty table with no content - or other loading issues such as missing filters - then this is normally caused by an AJAX error or conflict in your theme.

You can test this by switching to a different theme (e.g. TwentySeventeen) and seeing whether the table loads. If the table loads ok in another theme then you will need to troubleshoot these issues in your theme. If the table doesn’t load when you switch themes, please submit a support request.

DataTables error

If you can see an error relating to datatables then this is normally caused by an AJAX error or conflict in your theme. You can test this by switching to a different theme (e.g. TwentySeventeen) and disabling all the plugins apart from Document Library Pro, and seeing whether the table loads. If the table loads ok then you can reactivate everything one by one to find the cause of the problem. If the table doesn’t load when you switch themes, please send us a support request.

Related Articles

If searching the knowledge base hasn't answered your question, please contact support.