Initializing help system before first use

# Table Layout and Display State Saving

The Table Columns of a Table that is placed in an unsized layout Column component will stretch to fit the longest content in any row in the column.

The Table will only wrap this content when total table width exceeds the section width. If the Table width still exceeds the section width after applying word-wrap, the relevant Section will display a horizontal scrollbar.

You can set a `width` attribute in pixels to control the width of a Table and individual Table columns. You can also control the width of a Table with the size attribute of the Layout Section or Column containing the table.

By default, the display state of each Table in a view is stored in the user's browser session. If a Table is redrawn or the user navigates back and forth between views or apps, the tables will remain in the same state. This includes:

- Global search values.
- Column search values.
- Column sorting.
- Pagination—page size, current page.

If a user closes the browser window or if they log in as a different user within the same browser window, the state for all tables is wiped—This state is only considered as temporary, retained while users are working within a given browser window or Xpress Insight session.

During view development, if you are changing the configuration of tables you may wish to disable table state saving temporarily. You may also wish to disable it permanently for particular tables in a view—To do this, add the `save-state="false"` attribute to the `<vdl-table>` element.

Parent Topic Using VDL tables

© 2001-2026 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.