docs/8.0/ayanova/docs/ay-start-form-data-tables.md

@@ -50,21 +50,57 @@ About menu option will open the [About form](ay-about.md) which displays the ver
 
 The data table header area above the table itself from left to right contains the [Saved filter](#saved-filter) control, refresh control which fetches a fresh copy of the data table from the server and a [column selector](#column-selector) control to choose which columns are displayed and in which order.
 
-#### Saved filter
+#### Saved filters
 
-todo: saved filter docs here
+The current set of filters on the columns of a data table can be saved so that they can be retrieved later without having to set them again or shared with other users.
+
+The saved filter control is used to edit, select and remove saved filters:
+
+![data table saved filter control](img/form-data-table-saved-filter-control.png)
+
+The central drop down list box displays all available saved filters to choose from. Selecting a filter here will cause the data table to apply the saved filter to the data table and refresh the data.
+
+##### De-selecting a saved filter
+
+The right side of the saved filter control contains a delete icon for removing any current filtering.
+You can also select the `-` none option from the saved filter pick list to remove any current filters.
+
+##### Saving filters
+
+[Create / edit filters](#filtering-data) then click on the edit icon to the left of the saved filter selection list to open the saved filter editor.
+
+![data table saved filter dialog](img/form-data-table-saved-filter-dialog.png)
+
+If you had a previously selected saved filter before making your edits to the filters then the saved filter dialog box will offer a `save` button in addition to the `save a copy` button. If you want to _overwrite_ the existing filter indicated with your new selections click on `save` and the existing saved filter of the same name will be replaced with the new selections. If you want to leave the existing filter and create a new one select `save a copy` instead.
+
+If you did not have a saved filter previously selected then the `save a copy` button will be the only save button displayed.
+
+**All users** - if you want to make your filter available to all users select the All users checkbox and save. If this is not selected the filter will not be available to any other user.
+
+##### Deleting filters
+
+Select the filter you wish to delete then click on the edit icon to the left of the saved filter selection list to open the saved filter editor and select `delete` to permanently remove the saved filter.
+
+##### Filtered hidden columns indicator
+
+If a saved filter is selected and one or more of the columns being filtered are not selected to display the data table will indicate this by highlighting the column selector icon:
+
+![data table filter hidden column](img/form-data-table-filter-hidden-column.png)
+
+In this example the [column selector](#column-selector) is highlighted because there is a filter applied to the `Head Office` column which is not set to display.
+
+It is not necessary to display a hidden column, this highlighting is to indicate to the user that one ore more columns are being filtered that are not visible.
 
 #### Column selector
 
 TODO: fill in here, do not change this title without chaging at the cilent end as well.
 
-
 ## Column headers
+
 ![data table columns header](img/form-data-table-columns-header.png)
 
 todo: fill in here how to use column headers and integrate infor belo0w in a #### level titles
 
-
 00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
 
 elements of the data table