# Sort and Filters ## Overview The Sort and Filter feature helps you easily find and organize mentorship programs on the Mentorship page. With these tools, you can: * **Sort** programs by different criteria (like name, status, or when they were last updated) * **Search** for specific programs by typing their name * **Filter** programs using multiple criteria (skills, dates, status, and more) * **Reset** all filters to start fresh This feature is available in the **Mentorships** tab and works across all program categories: All Mentorships, Accepting Applications, In Progress, and Completed. *** ## Where to Find It The sort and filter controls are located in a toolbar above the program cards. You'll see them arranged from left to right: **Sort Dropdown → Search Box → Reset Filters Button → Filter Button** ![Sort and Filter Toolbar](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-7c4be75c92a298982ce6075cf9257af778e15d7c%2Ftoolbar-overview.png?alt=media) *** ## Features ### 1. Sort Programs The sort dropdown lets you organize programs in different ways to find what you're looking for faster. #### Available Sort Options | Sort Option | What It Does | | -------------------------- | ------------------------------------------------------------------------------- | | **Accepting First** | Shows programs that are currently accepting applications at the top of the list | | **Completed First** | Shows completed programs at the top of the list | | **Name (A-Z)** | Arranges programs alphabetically by name (A to Z) | | **Name (Z-A)** | Arranges programs in reverse alphabetical order (Z to A) | | **Updated (Oldest First)** | Shows programs that were updated longest ago first | | **Updated (Newest First)** | Shows the most recently updated programs first | #### Default Setting By default, programs are sorted with "Accepting First" - this means programs that are currently accepting applications will appear at the top of your list. #### How to Use 1. Click on the sort dropdown (the small dropdown menu in the toolbar) 2. Select the sort option you want from the list 3. The program list will automatically update with your new sort order ![Sort Dropdown Open](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-ec8e948616a329574114c23da389a57ea7092a0f%2Fsort-dropdown-open.png?alt=media) **Note:** Your sort preference will stay active as you switch between different program tabs (All Mentorships, Accepting Applications, etc.) until you change it. *** ### 2. Search for Programs The search box helps you quickly find specific programs by name. #### Features * **Smart suggestions:** As you type (after 3 characters), a list of matching programs appears below the search box * **Quick search:** Press Enter on your keyboard to search for what you typed * **Easy clearing:** Click the × button to clear your search and see all programs again #### How to Use 1. Click in the search box 2. Start typing the name of the program you're looking for 3. After typing at least 3 characters, you'll see suggestions appear 4. You can either: * Click on a suggestion from the dropdown list, or * Press Enter to search for exactly what you typed 5. The program list will update to show matching results 6. To clear your search, click the × button in the search box ![Search Suggestions](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-3dfdcb38645dd02b734fc5bf6a14148062f0e61c%2Fsearch-suggestions.png?alt=media) **Tip:** The search works together with your sort and filter settings, so you can search within filtered results. *** ### 3. Filter Programs The filter feature gives you powerful options to narrow down programs based on specific criteria. #### Available Filters **Program Term Name** * **What it does:** Search for programs by their program term name (like "Summer 2024" or "Fall Program") * **How to use:** Type the term name you're looking for in the text box * **Example:** Type "Summer" to find all programs with "Summer" in their term name **Program Status** * **What it does:** Filter programs by whether they're accepting applications, in progress, or completed * **How to use:** Select one status from the dropdown menu * **Options:** * Accepting Applications * In Progress * Completed * **Note:** This filter is automatically hidden when you're already viewing a specific status tab (like the "Accepting Applications" tab) **Required Skills** * **What it does:** Find programs that require specific skills * **How to use:** Select one or more skills from the dropdown menu * **How it works:** If you select multiple skills (like "JavaScript" and "Python"), you'll see programs that require ANY of those skills * **Example:** Selecting both "JavaScript" and "Python" will show you all programs that need either skill **Program Term Date Range** * **What it does:** Find programs based on when their program term runs * **How to use:** Select a start date and/or end date using the calendar picker * **How it works:** You'll see programs if any part of their term falls within your selected date range * **Example:** If you select January 1 to March 31, you'll see all programs with terms that overlap that period #### How to Use Filters 1. Click the "Filter" button (the button with a filter icon) in the toolbar 2. A filter dialog window will open 3. In the dialog, you can: * **Add filters:** Click on any filter type to activate it * **Configure filters:** Enter text, select options, or choose dates depending on the filter type * **Remove filters:** Click the × button next to any active filter to remove it * **Get help:** Click the info icon (ℹ️) next to any filter to see more details about how it works 4. Once you've set up your filters, close the dialog window 5. The program list will automatically update to show only programs matching your filters 6. A "Reset Filters" button will appear in the toolbar when you have active filters ![Filter Dialog](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-388649d161bda396787fa73a43ec0e5a9aa94225%2Ffilter-dialog.png?alt=media) ![Active Filters](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-43375749244eb70ffd6e9811288ddf04d5c11b03%2Factive-filters.png?alt=media) **Tip:** You can use multiple filters at the same time. For example, you could filter by skills AND date range to find very specific programs. *** ### 4. Reset Filters The "Reset Filters" button lets you quickly clear all your active filters and return to the default view. #### When You'll See It * The "Reset Filters" button appears in the toolbar when you have at least one filter active * It's located next to the Filter button * It's shown in red text to make it easy to spot ![Reset Filters Button](https://3411187760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2DCN9UgoRgMEkgnLyP-887967055%2Fuploads%2Fgit-blob-af6853f134d87aa1d37565e4ed0eac56e9e76649%2Freset-filters-button.png?alt=media) #### How to Use 1. Click the "Reset Filters" button 2. All your filters will be cleared immediately 3. The program list will refresh to show all programs (with your current sort and search settings) 4. The reset button will disappear once all filters are cleared **Note:** Resetting filters does NOT clear your search or sort settings - only the filter criteria. *** ## Summary The Sort and Filter feature provides you with powerful tools to find exactly the mentorship programs you're looking for. You can use these features individually or combine them for more precise results: * Use **Sort** to organize programs in a way that makes sense to you * Use **Search** when you know the program name * Use **Filters** to narrow down by skills, dates, or status * Use **Reset Filters** to quickly start fresh All these features work together seamlessly, making it easy to discover the perfect mentorship opportunities that match your interests and availability. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.linuxfoundation.org/lfx/mentorship/platform-overview/mentorship-sort-filter.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.