Create advanced filters with ShowQL Updated September 20, 2023 18:32 The Showpad Query Language (ShowQL) is a powerful and user-friendly query language that lets you define sophisticated criteria to precisely target assets within your file library. As you build your filter, it is automatically applied. See how it looks Key features Organize assets in the Content Library Create filters based on one or more criteria Use these filters to export a specific list of assets You need this to succeed Showpad Enterprise package Showpad Administrator or promoted user account The quick way to awesomeness To create filters using ShowQL, it's important to understand their construction and logic. This will ensure that you're able to use ShowQL effectively to locate and filter assets within your Showpad content Library. There are two types of filters you can build: Simple query - This is a filter that uses a single statement. You need to select an identifier, an operator, and a value. The identifier tells Showpad where to look, and the value defines what you're looking for. The operator determines how to compare the identifier and the value. Combined queries - This is a more complex filter in which you can combine multiple statements by using one of the following logical operators: AND - This operator returns content that matches both statements. OR - This operator returns content that matches either statement. Case Sensitivity for Values Manually entered text values are case-sensitive. This means that your results could be affected because "a" and "A" are treated as two distinct letters. However, this is not the case when using the contains (~) or does not contain (!~) operators. When using either of these operators, manually entered text values must be lower case. Do this step by step Click Library in the top menu. If your organization uses Divisions, click the relevant Division. Click the Advanced button to access the ShowQL guided query builder. You can return to basic filtering by clicking on the Basic button (displayed when viewing advanced options). Click in the search bar and select one of the available attributes. Select a comparison operator by clicking on the option presented in the search bar. This defines how the selected attribute is compared to the value. The available operators depend on the type of attribute selected. Click in the search bar to select or enter the value you want to find. Only values that correspond to the selected attribute are displayed. You can add another criterion to your search by clicking on + add. This will add a logical operator between your search criteria. You can click on the displayed operator to change it. and - This operator is selected by default. Using this operator will require that any results returned must match both of your search criteria. or - This operator will return results that match either of the criteria. You can continue adding additional criteria by repeating the steps above. Click the Enter key to finish your query. Note: You can clear the search bar at any time by clicking on Reset in the search bar. Identifiers and Operators Showpad identifiers are grouped into four themes. The following table provides details about the available identifiers and the operators that can be used with them. Theme Identifier Available Operators Description File File type is (=) is not (!=) You can select one of the following file types: Document Photo Raw SCORM Video Audio Webapp URL File name contains (~) does not contain (!~) is (=) is not (!=) Notes: The value must: have at least 5 characters have no more than 24 characters be lowercase not include special characters File size less than (<) less than or equals (<=) greater than (>) greater than or equals (>=) Enter a value in Mb. File content contains (~) does not contain (!~) Allows you to search the content inside documents that have indexed text.Notes: The value must: have at least 5 characters be a single word. Divisions is (=) is not (!=) Select a division from the displayed list. Data Author contains (~) does not contain (!~) Select one or more users from the displayed list. Language all any none Select one or more languages from the displayed list. Country all any none Select one or more countries from the displayed list. Permissions is (=) is not (!=) You can select one of the following permissions: Can be annotated Can be downloaded internally Restrict internal download PDF Can be downloaded externally Restrict external download PDF Only entire document is shareable Can be shared Can be personalized Page groups are enforced Global Show in kiosk mode Tags all any none Select one or more tags from the displayed list. Type to search list. Analytics Comments less than (<) less than or equals (<=) greater than (>) greater than or equals (>=) Enter a number. Likes less than (<) less than or equals (<=) greater than (>) greater than or equals (>=) Enter a number. Views less than or equals (<=) greater than (>) greater than or equals (>=) Enter a number. Other Description contains (~) does not contain (!~) Notes: The value must: have at least 5 characters be a single word. External ID is (=) is not (!=) Note: The value must have at least 5 characters. Slug is (=) is not (!=) Note: The value must have at least 5 characters. Related articles 2023 Install custom Showpad Apps Share Collections with Colleagues Edit an existing Experience Give users more permissions as Promoted Members