# Document filtering during indexing This page contains a description of the use of document filters for indexing, as well as descriptions of all types of filters with examples of their creation. This page contains a description of the use of document filters for indexing, as well as descriptions of all types of filters with examples of their creation. ## Setting a filter To indicate which documents from adding folders should be indexed and which not, the [setDocumentFilter](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings#setDocumentFilter(com.groupdocs.search.DocumentFilter)) method of the [IndexSettings](https://reference.groupdocs.com/search/nodejs-java/com.groupdocs.search/IndexSettings) class can be used to specify a filter based on various properties of these documents. If a document adding separately or located in an adding folder does not match the filter, then it will not be added and indexed. The default value is null, which means that all added files will be indexed if their format is supported. The following example demonstrates how to set a document filter for indexing. ```javascript const indexFolder = 'c:/MyIndex'; const documentsFolder = 'c:/MyDocuments'; // Creating a filter that skips documents with extensions '.doc', '.docx', '.rtf' const settings = new groupdocs.search.IndexSettings(); const fileExtensionFilter = groupdocs.search.DocumentFilter.createFileExtension('.doc', '.docx', '.rtf'); // Creating file extension filter that allows only specified extensions const invertedFilter = groupdocs.search.DocumentFilter.createNot(fileExtensionFilter); // Inverting file extension filter to allow all extensions except specified ones settings.setDocumentFilter(invertedFilter); // Creating an index in the specified folder const index = new groupdocs.search.Index(indexFolder, settings); // Indexing documents index.add(documentsFolder); ``` ## Creation time filters The first type of filters is based on the time the document file was created. Such filters can skip files created earlier than a certain date, later than a certain date, or outside a certain range of dates. Examples of these filters are given below. ```javascript // The first filter skips files created earlier than January 1, 2017, 00:00:00 a.m. const filter1 = groupdocs.search.DocumentFilter.createCreationTimeLowerBound(Utils.createDate(2017, 1, 1)); // The second filter skips files created later than June 15, 2018, 00:00:00 a.m. const filter2 = groupdocs.search.DocumentFilter.createCreationTimeUpperBound(Utils.createDate(2018, 6, 15)); // The third filter skips files created outside the range from January 1, 2017, 00:00:00 a.m. to June 15, 2018, 00:00:00 a.m. const filter3 = groupdocs.search.DocumentFilter.createCreationTimeRange( Utils.createDate(2017, 1, 1), Utils.createDate(2018, 6, 15), ``` ## Modification time filters The next type of filters works similarly, but based on the document file modification date. Examples are presented below. ```javascript // The first filter skips files modified earlier than January 1, 2017, 00:00:00 a.m. const filter1 = groupdocs.search.DocumentFilter.createModificationTimeLowerBound(Utils.createDate(2017, 1, 1)); // The second filter skips files modified later than June 15, 2018, 00:00:00 a.m. const filter2 = groupdocs.search.DocumentFilter.createModificationTimeUpperBound(Utils.createDate(2018, 6, 15)); // The third filter skips files modified outside the range from January 1, 2017, 00:00:00 a.m. to June 15, 2018, 00:00:00 a.m. const filter3 = groupdocs.search.DocumentFilter.createModificationTimeRange( Utils.createDate(2017, 1, 1), Utils.createDate(2018, 6, 15), ); ``` ## File path filters The next type of filters allows you to set a regular expression for skipping those documents whose full paths do not match the specified pattern. This type of filters uses the **java.util.regex.Pattern** class to compare with a pattern. ```javascript // Creating a filter that skips files that do not contain the word 'Ipsum' in their paths const filter = groupdocs.search.DocumentFilter.createFilePathRegularExpression('Ipsum', java.getStaticFieldValue('java.util.regex.Pattern', 'CASE_INSENSITIVE')); ``` ## File length filters The following group of filters uses the file length in bytes for filtering. It is possible to specify a lower bound, an upper bound or the range of acceptable file length. Examples are below. ```javascript // The first filter skips documents less than 50 KB in length const filter1 = groupdocs.search.DocumentFilter.createFileLengthLowerBound(50 * 1024); // The second filter skips documents more than 10 MB in length const filter2 = groupdocs.search.DocumentFilter.createFileLengthUpperBound(10 * 1024 * 1024); // The third filter skips documents less than 50 KB and more than 100 KB in length const filter3 = groupdocs.search.DocumentFilter.createFileLengthRange(50 * 1024, 100 * 1024); ``` ## File extension filter The following type of filters allows you to specify a list of valid file extensions for indexing. ```javascript // This filter allows indexing only FB2, EPUB, and TXT files const filter = groupdocs.search.DocumentFilter.createFileExtension('.fb2', '.epub', '.txt'); ``` ## Logical NOT filter The next type of filter allows you to invert the logic of an internal filter. ```javascript const settings = new groupdocs.search.IndexSettings(); const filter = groupdocs.search.DocumentFilter.createFileExtension('.htm', '.html', '.pdf'); const invertedFilter = groupdocs.search.DocumentFilter.createNot(filter); // Inverting file extension filter to allow all extensions except of HTM, HTML, and PDF settings.setDocumentFilter(invertedFilter); ``` ## Logical AND filter The filter of the following type allows you to compose a complex filter from several other filters, using the logic "AND". This composite filter requires the simultaneous fulfillment of the conditions of all internal filters for each file to be added. The example below shows how to make a filter that allows indexing only documents created in the date range from 01/01/2015 to 01/01/2016, with the extension '.txt' and a size of no more than 8 MB. ```javascript const settings = new groupdocs.search.IndexSettings(); const filter1 = groupdocs.search.DocumentFilter.createCreationTimeRange( Utils.createDate(2015, 1, 1), Utils.createDate(2016, 1, 1), ); const filter2 = groupdocs.search.DocumentFilter.createFileExtension('.txt'); const filter3 = groupdocs.search.DocumentFilter.createFileLengthUpperBound(8 * 1024 * 1024); const finalFilter = groupdocs.search.DocumentFilter.createAnd(filter1, filter2, filter3); settings.setDocumentFilter(finalFilter); // Setting the filter ``` ## Logical OR filter The filter of the following type allows you to compose a complex filter from several other filters, using the logic "OR". This composite filter requires fulfillment of the condition of at least one internal filter for each added file. The example below shows how to create a filter that limits the size of text files to 5 mb and other files to 10 mb. ```javascript const settings = new groupdocs.search.IndexSettings(); const txtFilter = groupdocs.search.DocumentFilter.createFileExtension('.txt'); const notTxtFilter = groupdocs.search.DocumentFilter.createNot(txtFilter); const bound5Filter = groupdocs.search.DocumentFilter.createFileLengthUpperBound(5 * 1024 * 1024); const bound10Filter = groupdocs.search.DocumentFilter.createFileLengthUpperBound(10 * 1024 * 1024); const txtSizeFilter = groupdocs.search.DocumentFilter.createAnd(txtFilter, bound5Filter); const notTxtSizeFilter = groupdocs.search.DocumentFilter.createAnd(notTxtFilter, bound10Filter); const finalFilter = groupdocs.search.DocumentFilter.createOr(txtSizeFilter, notTxtSizeFilter); settings.setDocumentFilter(finalFilter); // Setting the filter ``` ## More resources ### GitHub examples You may easily run the code from documentation articles and see the features in action in our GitHub examples: * [GroupDocs.Search for .NET examples](https://github.com/groupdocs-search/GroupDocs.Search-for-.NET) * [GroupDocs.Search for Java examples](https://github.com/groupdocs-search/GroupDocs.Search-for-Java) ### Free online document search App Along with full featured .NET library we provide simple, but powerful free Apps. You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online [Free Online Document Search App](https://products.groupdocs.app/search).