1. Home
  2. Document Library Pro
  3. Document Library Options

Document library table column widths

Document Library Pro automatically sizes the columns for the best fit, when using the table layout. There are several options to override this behavior to control the column widths, as well as the image sizes in the table.

This is a way to force more or less space for specific columns. For example, you can increase the width of the content column if there is a lot of content to display.

Column widths

To override the default column widths, use the widths option. You need to enter a value for each column in your table – either a percentage, a pixel amount or the word auto to have the plugin calculate the width automatically.

For example, you might have 3 columns in your table: title, content and date - and you want to set the width of the title column to 20%, the content column to 50% and the date column to 30%.

You can achieve this with the following shortcode:[doc_library columns="title,content,date" widths="20%,50%,30%"]

In the next example, we want to set the width of the first column to 50px and automatically size the other columns. We would use:
[doc_library columns="title,content,date" widths="50px,auto,auto"]

As auto is the default column width when no value is given, the above example can be simplified to the following:
[doc_library columns="title,content,date" widths="50px"]

Common problems

The widths option isn't working

If the widths option isn't working, then it might be that you have set the width too narrow and the contents will no longer fit in the column. Instead of allowing it to look broken, the plugin will make the width wider so that the contents fit. Try increasing the width of the affected columns.

I have multiple tables on the same page and I want them all the to line up

The column widths are calculated for each table individually. If you have more than one table on a page, you can use the widths option to force the widths to be the same for each table by giving each table the same widths value.

My column widths change when I move from one page to the next, or use the filters

This can happen if the contents of a column contains a different number of characters for each document. The width of each column of the table is calculated based on the current documents on that page, so this might change when you perform a filter or go from one page to the next. Use the widths option to force the columns to always be the same width.

Related Articles

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