Merge pull request #10428 from NielsKunst/apps-filter-project-categories

Apps filter project categories

Author: NicoletaComan

content/en/docs/control-center/company/project-categories.md

@@ -0,0 +1,45 @@
+---
+title: "Project Categories"
+url: /control-center/project-categories/
+description: "Manage Project Categories."
+weight: 50
+---
+
+## Introduction
+
+The **Categories** page allows you to manage the categories that can be assigned to your company's apps, so as to improve classification and searchability.     
+You can also manage project categories through the [Project Category API](/apidocs-mxsdk/apidocs/project-category-api/).
+
+Categories can be assigned to each app individually on the app's [Settings](/developerportal/general-settings/) page, but you can also use the [Projects API](/apidocs-mxsdk/apidocs/projects-api/) to edit the category assignment.
+
+## Category Management
+
+On the **Categories** page, you can manage app categories. A list of preconfigured categories is displayed, along with all their corresponding values. Next to the preconfigured **Country** category, you can configure a maximum of five categories with 250 values each. 
+
+Use the **Add Country Category** to make the preconfigured **Country** category available, along with its list of 250 countries.
+
+{{% alert color="info" %}}
+You cannot edit the preconfigured **Country** category.
+{{% /alert %}}
+
+### Adding Categories
+
+Follow these steps to add a category:
+
+1. Click the **Add Category** button. This opens the **Add Category** pop-up window.  
+2. In the **Category Name** field, enter a name for the new category.
+3. Click **Add Value** to add one or more values for the new category.   
+    You can add multiple values as a comma-separated list.    
+    Each entry consists of a unique name and code. The unique code is automatically generated for you. You can edit it afterwards, as long as you provide a new unique code.
+
+### Editing Categories
+
+Follow these steps to edit a category:
+
+1. Click the **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) button within a category, then click **Edit**. This opens the **Add Category** pop-up window.
+2. Make edits as necessary, such as changing the category name, or adding or removing values.
+3. Click **Save**.
+
+### Deleting Categories
+
+To delete a category, click the **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) button within a category, then click **Delete**.

content/en/docs/developerportal/_index.md

@@ -54,6 +54,12 @@ You can filter the overview to display only the apps that are marked for deletio
 
 Use the drop-down menu on the right side of the page to sort the apps by **Pinned**, **Recent Activity** or in alphabetical order of **App Name**.
 
+You can filter by the assigned **Project Categories** by clicking the **Filter** ({{% icon name="filter" %}}) button on the right side. The available categories are displayed in a side panel.     
+Categories are maintained by the [Mendix Admins](/control-center/mendix-admins-page/) of your company, on the [Project Categories](/control-center/project-categories/) page in Control Center.     
+If you have the **App Settings** permission, you can assign categories to an app on the app's [Settings](/developerportal/general-settings/) page, helping to improve classification and searchability.
+
+{{< figure src="/attachments/developerportal/general/apps/myapps-filter.png" >}}
+
 ### App Tiles {#app-tiles}
 
 You can pin an app tile by clicking **Pin** ({{% icon name="pin" %}}). Pinned apps appear at the top of the list.

content/en/docs/developerportal/general/overview.md

@@ -19,10 +19,8 @@ At the top of the page, you can find key information about your app, such as its
 On the right side of the page, you can find the following information about your app:
 
 * The size of your **Team** and your team members. Up to 5 team members can be displayed here at a time.
-* The name of the **Company** owning the app.
-* The **Deployment Provider** where your app is deployed, and, if the target is the public Mendix Cloud, the **License State** of the app.
-* The date of the **Last Commit to the Main Line** of your app. This is only available if you have access to the app on the Team Server.
-* The **Mendix Version** of your app on main line. This is only available if you have access to the app on the Team Server.
+* The **Project Details** section, which displays the categories assigned to the project. The assigned categories allow you to easily classify and search apps on the [Apps](/developerportal/) page.     
+    If you have the **App Settings** permission, you can change the assigned categories on the [Settings](/developerportal/general-settings/) page.
 
 Click **Invite someone to your team** ({{% icon name="add-circle" %}}) to invite new members to your team directly. 
 

content/en/docs/developerportal/settings/_index.md

@@ -50,6 +50,7 @@ On this tab, you can find the following items:
 * **Description** of the project
 * **Project ID**
 * [Technical Contact](/developerportal/general/app-roles/#technical-contact) of the app
+* **Categories**
 * **Danger Zone**
     * **Leave Project**
     * **Deactivate Project**
@@ -59,7 +60,8 @@ On this tab, you can find the following items:
 Only users with the **App Settings** permission can do the following:
 
 * Change the description of the project.
-* Deactivate or delete a project. For details, see [Leaving, Deleting, or Deactivating an App](/developerportal/general/leave-delete-app/).
+* Change the category assignment of the project.
+* Deactivate or delete a project. For details, refer to [Leaving, Deleting, or Deactivating an App](/developerportal/general/leave-delete-app/).
 {{% /alert %}}
 
 ## Cloud Settings {#cloud-settings}

content/en/docs/releasenotes/control-center/_index.md

@@ -14,6 +14,14 @@ To see the current status of the Mendix Control Center, see [Mendix Status](http
 
 ## 2025
 
+### December 14, 2025
+
+#### New Features
+
+* The Control Center **Company** section now includes a new page, **Project Categories**. It allows admins to create and manage the categories that can be assigned to your company's apps. When apps are assigned their categories, either by the company admins or the admins of specific apps, the categories are then visible to all company members on My Apps and My Company Apps pages in the Mendix Portal, which enables better classification and searchability. Categories can also be managed using the new [Project Category API](/apidocs-mxsdk/apidocs/project-category-api/).     
+    For details on the new page, refer to [Project Categories](/control-center/project-categories/).     
+    For details on the corresponding app filter, refer to [Apps](/developerportal/).
+
 ### November 9, 2025
 
 #### Improvements

content/en/docs/releasenotes/developer-portal/_index.md

@@ -21,6 +21,14 @@ To see the current status of the Mendix Portal, see [Mendix Status](https://stat
 
 ## 2025
 
+### December 14, 2025
+
+#### New Features
+
+* You can now filter apps based on a series of categories which are managed by Mendix Admins on the Control Center **Project Categories** page. This ensures that apps are efficiently classified and easily searchable.    
+    For details on the new Control Center page, refer to [Project Categories](/control-center/project-categories/).      
+    For details on the new **Apps** filter, refer to the [My Apps](/developerportal/#my-apps) section in *Apps*.
+
 ### December 4
 
 #### Improvements

layouts/partials/landingpage/latest-releases.html

@@ -10,7 +10,7 @@ <h4 class="lp-panel-title">Latest Releases</h4>
     </li>
     <li class="lp-panel-list">
         <a href="/releasenotes/developer-portal/">Apps</a>
-        <p class="rn-date">December 4, 2025</p>
+        <p class="rn-date">December 14, 2025</p>
     </li>
     <li class="lp-panel-list">
         <a href="/releasenotes/developer-portal/deployment/">Deployment</a>