Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
155 changes: 98 additions & 57 deletions content/en/docs/developerportal/app-insights/feedback.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ After a user reports feedback in the app using the feedback widget, they get an
* Summary of the feedback that your team wrote
* To which team member the feedback is assigned
* Tags that are assigned to the feedback
* Other feedback items that are associated with this feedback
* Other feedback that is associated to this feedback
* Attachments that you team uploaded for this feedback
* Team comments on this feedback

Expand All @@ -61,16 +61,17 @@ On the **Inbox** tab, everyone from your team can view all the unarchived feedba

{{< figure src="/attachments/developerportal/app-insights/feedback/feedback-items.png" alt="inbox tab" >}}

In the list on the **Inbox** tab, you can find the following information for each feedback item:
In the list on the **Inbox** tab, you can find the following information for each piece of feedback:

* **ID** – the unique number that is assigned to the feedback
* **Subject** – the title of the feedback given by the reporter
* **Submitter** – the email address of the reporter
* **Tags** – tags that your team has assigned to the feedback
* **Status** – the status that your team has set to the feedback
* **Linked** – the number of the feedback items that are linked to this feedback
* **Priority** – the priority that the feedback has
* **Date** – the date when the feedback was submitted
* **ID** – The unique number that is assigned to the feedback
* **Subject** – The title of the feedback given by the reporter
* **Group** – The group that the feedback belongs to
* **Submitter** – The email address of the reporter
* **Tags** – Tags that your team has assigned to the feedback
* **Status** – The status that your team has set to the feedback
* **Date** – The date when the feedback was submitted
* **Stories** – The story that the feedback is linked to
* **Priority** – The priority that the feedback has

For more information about each item, refer to the [Feedback Details](#feedback-details) section.

Expand All @@ -82,42 +83,96 @@ Clicking the filter bar opens the **Filter by** side panel. In this side panel,

### Organizing Feedback in Inbox

If your [role](/developerportal/general/app-roles/) has the **Can edit ‘Stories, Documents and Feedback'** permission, you can also organize feedback items.
You can add new feedback manually yourself. To do that, follow these steps:

1. Click **Create new feedback** if there is no feedback yet in the **Inbox** tab.
Click **Add feedback** if there is already feedback in the **Inbox** tab.

2. Fill in the **Subject**, **Description**, and **Submitter Email** fields, and optionally **Upload Screenshots** in the **New Feedback** dialog box.

You can add new feedback manually yourself.
If you select feedback from the list, you can see the following options:

To manually add feedback:
* **Group Items** – Clicking this button reveals two options:

* Click **Create new feedback** if there is not any feedback yet in the **Inbox** tab.
* Click **Add feedback** if there is already feedback in the **Inbox** tab.
* **Create New Group** – You can create a new group for the selected feedback.
* **Add to Group** – You can add the selected feedback to an existing group.

Then, fill in the **Subject**, **Description**, and **Submitter Email** fields, and optionally **Upload Screenshots** in the **New Feedback** dialog box.
* **Create Story** – If your app is connected to [Epics](/developerportal/project-management/epics/) or [Jira](/developerportal/project-management/jira-connector/), clicking this button converts the selected feedback to stories on the designated board in Epics or Jira.
The following options are available:

If you select feedback, you can see the following items:
* **Create Story** – Create a new story based on the feedback.
* **Add to Story** – Add the feedback to an existing story.

{{< figure src="/attachments/developerportal/app-insights/feedback/bulk-actions-bar.png" alt="bulk-actions-bar" >}}
* **Change Status** – Change the status of the selected feedback.

* **Link** – Clicking this links the feedback together into one feedback group.
* **Move to App** – Move the selected feedback to any other app of which you are a member. This action removes the link to the group if the feedback is part of a feedback group.

You need to choose which item is the primary item of the group. After the feedback items are linked, only the primary feedback item appears in the list. The feedback items that are linked to the primary item disappear from the list. You can only access these linked feedback items from their primary item. If you change the status of the primary feedback item, all the linked items get the same status automatically.
* **Archive** – Set the selected feedback as archived.

{{% alert color="info" %}}When you open a linked feedback, you can click **Make [the linked feedback] the Primary feedback** to make this feedback the primary feedback of the feedback group instead.{{% /alert %}}
* **Delete** – Delete the selected feedback permanently. The result is irreversible.

* **Move** – Clicking this moves the selected feedback item to any other app of which you are a member. Whenever you move feedback, you also move all linked feedback. If you only want to move one feedback item, you need to unlink the feedback from the group first.
## Groups {#groups}

* **Create Stories** – If your app is connected to [Epics](/developerportal/project-management/epics/) or [Jira](/developerportal/project-management/jira-connector/), clicking this button converts the selected feedback item to stories on the designated board in Epics or Jira.
On the **Groups** tab, everyone on your team can view all feedback groups in your app.

* Status drop-down list – You can select a status from the drop-down list and then click **Apply** to change the status of the selected feedback item.
In the list on the **Groups** tab, you can find the following information for each group:

* **Group Name** – The name of the group
* **Status** – The status of the group
* **Priority** – The priority of the group
* **Assignee** – The assignee of the group
* **Number of Items** – How many pieces of feedback the group contains

You can use the search bar above the list to find group by name, assignee, status, and priority.

You can also create a new group from this page by clicking **Add Group** button.

### Group Details {#group-details}

On the **Groups** tab, you can open group details by clicking the group in the list.
The following options are available:

* **Ungroup** – Ungroup all feedback in the group. This action does not delete the group.
* **Delete Group** – Delete the group and all feedback within it. This action is destructive and, once you delete a group with feedback, the feedback is also deleted.
* Group Name – The name of the group, which you can edit by clicking it.
* **Description** – The description of the group.
* **Tags** – Any tags assigned to the group.
You can either select a tag from the drop-down list, or create a new tag by typing its name inside the text box, then clicking **Create [the tag name]**.
A tag should contain maximum 50 characters.
You can assign multiple tags.

{{< figure src="/attachments/developerportal/app-insights/feedback/tags.png" class="no-border" >}}

* **Archive** – Clicking this sets the selected feedback item as archived.
For more information on tags, refer to the [Managing Tags](#manage-tags) section.

* **Delete** – Clicking this deletes the selected feedback item permanently. The result is irreversible.
* **Status** – The status of the group. There are two default statuses: **New** and **Closed**.
Whenever you create a new group in the app, it is set to **New**.
You can add custom statuses by clicking **Manage Statuses** ({{% icon name="cog" %}}), and adding the new statuses in the dialog box. Custom statuses can only be used for feedback that is not archived or for groups. You can filter your feedback based on the status.
You can edit the default status name by clicking **Manage Statuses** ({{% icon name="cog" %}}), then clicking the status name.

* **Assigned To** – The person to whom the group is assigned. When you assign a group to someone, they get an email notification.

* **Priority** – The priority that the group has.

* **Reply To All** – You can reply to the submitters of all the feedback in the group. The same message is sent to all of them.

* **Grouped Feedback** – This displays a list of the pieces of feedback that are linked to the group. If you click an item in the list, it will show you the feedback details in the side panel.

* **ID** – The unique number that is assigned to the feedback. Clicking the ID opens the feedback details in a new page.
* **Subject** – The title of the feedback given by the reporter
* **Action** – This column contains the following actions for each piece of feedback:

* **Reply to Submitter** – Reply to the submitter of the feedback.
* **Ungroup feedback** – Ungroup the feedback from the group.

* **Group Team Comments** – Displays all the comments left by your team for this group. You can leave comments here and add attachments to each comment.
Comments submitted here are only visible to your team members.

## Archive {#archive}

On the **Archive** tab, everyone in your team can view all the archived feedback.

In the list on the **Archive** tab, you can find the following information for each feedback item:
In the list on the **Archive** tab, you can find the following information for each feedback:

* **ID** – the unique number that is assigned to the feedback
* **Subject** – the title of the feedback given by the reporter
Expand All @@ -135,12 +190,10 @@ Clicking the filter bar opens the **Filter by** side panel. In this side panel,

## Feedback Details {#feedback-details}

On the [Inbox](#inbox) and the [Archive](#archive) tabs, you can open feedback details by clicking the feedback item in the list:
On the [Inbox](#inbox) and the [Archive](#archive) tabs, you can open feedback details by clicking the feedback in the list:

* If you click the **ID** of the feedback item, the feedback details open in a new page.
* If you click a place other than the **ID** of the feedback item, the feedback details open as a side panel.

{{% alert color="info" %}}If your [role](/developerportal/general/app-roles/) has the **Can edit ‘Stories, Documents and Feedback'** permission, you can edit the feedback details on the **Feedback** tab.{{% /alert %}}
* If you click the **ID** of the feedback, the feedback details open in a new page.
* If you click a place other than the **ID** of the feedback, the feedback details open as a side panel.

The following items are available:

Expand All @@ -149,7 +202,7 @@ The following items are available:
* {{% icon name="view" %}} – Click this button to stop receiving notifications for this feedback.
* **Copy Link** ({{% icon name="hyperlink" %}}) – Click this button to copy the URL to the feedback. You can send the URL to other people.
* **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) – Click this button to open a menu with the following items:
* **Move** – Click this button to move the feedback to any other app of which you are a member. Whenever you move feedback, you also move all linked feedback. If you only want to move one feedback item, you need to unlink the feedback from the group first.
* **Move** – Click this button to move the feedback to any other app of which you are a member. This action will remove the link to the group if the feedback is part of a feedback group.
* **Create Story** – If your app is connected to [Epics](/developerportal/project-management/epics/) or [Jira](/developerportal/project-management/jira-connector/), clicking this button converts the feedback to a story on the designated board in Epics or Jira. Once the story is created, clicking this button brings you to the story on the board right away.
You can also create feedback-based stories using Maia. For details, refer to the [Creating Stories with Maia](#create-with-maia) section.
* **Delete** – Click this button to remove the feedback permanently from **Feedback**. The result is irreversible.
Expand All @@ -159,7 +212,7 @@ The following items are available:
* **Priority** – This shows the priority that the feedback has.

* **Status** – This is the status of the feedback. There are two default statuses: **New** and **Closed**. Whenever feedback arrives in the app, it is set to **New**. When you close feedback, it is set to **Closed** and moved to the **Archived** page.
You can add custom statuses by clicking **Manage Statuses** ({{% icon name="cog" %}}) and adding the new statuses in the dialog box. Custom statuses can only be used for feedback items that are not archived. You can filter your feedback based on the status.
You can add custom statuses by clicking **Manage Statuses** ({{% icon name="cog" %}}) and adding the new statuses in the dialog box. Custom statuses can only be used for feedback that are not archived. You can filter your feedback based on the status.
You can edit the default status name by clicking **Manage Statuses** ({{% icon name="cog" %}}), then clicking the status name.

* **Tags** – These are the tags assigned to the feedback. You can select a tag from the drop-down list or create new tags by typing the tag name inside the text box and then clicking **create [the tag name]**. A tag should contain maximum 50 characters. You can assign multiple tags.
Expand All @@ -183,40 +236,28 @@ The following items are available:
* **Submitter email** – This shows the email of the reporter
* **Submission date** – This shows the date when the feedback was submitted

* **Linked Feedback** – This shows which feedback items are linked to this feedback.

You can link a feedback item by selecting it from the drop-down list.

{{< figure src="/attachments/developerportal/app-insights/feedback/linked-feedback.png" class="no-border" >}}

Once the feedback is linked, it disappears from the list on the **Inbox** or **Archive** tab. You can only access the linked feedback from its primary feedback to which it is linked. If you change the status of the primary feedback, all the linked feedback gets the same status automatically.

{{% alert color="info" %}}When you open a linked feedback item, you can click **Make [the linked feedback item] the Primary feedback** to make this feedback the primary feedback of the feedback group instead.{{% /alert %}}

You can unlink a feedback item by hovering over the feedback and clicking the **Remove** ({{% icon name="remove" %}}) button. Once the feedback is not linked anymore, it appears again in the list on the **Inbox** or **Archive** tab.

* **Story** – This displays any stories that are linked to that feedback item.
To unlink a story from a feedback item, click its corresponding {{% icon name="unlink" %}} **unlink** button.
* **Story** – This displays any stories that are linked to that feedback.
To unlink a story from a piece of feedback, click its corresponding {{% icon name="unlink" %}} **unlink** button.
If there are no linked stories, you have the following options:

* **Add to Story** – Add the feedback item to an existing story.
* **Create Story** – Create a new story based on the feedback item.
* **Add to Story** – Add the feedback to an existing story.
* **Create Story** – Create a new story based on the feedback.

* **Attachments** – This contains attachments to this feedback. To upload an attachment, click **Add** ({{% icon name="add" %}}) and select the file. The following formats are supported: .*peg*, *.png*, and *.gif*. Each attachment can be a maximum of 5 MB in size. Once an attachment is uploaded, only your team members can view, download, and delete the attachment.

* **Communication** – This section is made up of the following tabs:

* **Team Comments** — Displays all the comments left by your team for this feedback. You can leave comments here and add attachments to each comment.
Comments submitted to this tab are only visible to your team members.
* **Contact Submitter** — Allows you to read messages from the reporter and reply to them. Whenever the reporter sends a message, it is shown in this section. Once you reply to a message from the reporter, they receive an email. When multiple feedback items are linked, the system only sends an email to the reporter of this specific feedback item, not other associated feedback items in the same group.
* **Contact Submitter** — Allows you to read messages from the reporter and reply to them. Whenever the reporter sends a message, it is shown in this section. Once you reply to a message from the reporter, they receive an email.
For more information, see the [What Happens to a User After They Submit Feedback](#what-happens-to-user) section.

### Creating Stories with Maia {#create-with-maia}

You can use Maia to create a story based on one or more feedback items. To do that, follow these steps:
You can use Maia to create a story based on one or more feedback. To do that, follow these steps:

1. Enable Maia in the app [Settings](/developerportal/general-settings/#maia-settings) page.
2. Select a feedback item from the list.
2. Select a piece of feedback from the list.
3. Click **Create Story**. The **Create Story** window is displayed.
4. Click {{% icon name="sparkles" %}}**Create with Maia**.
If Maia is enabled, the **Create Story with Maia** window is displayed.
Expand All @@ -229,7 +270,7 @@ You can use Maia to create a story based on one or more feedback items. To do th

A banner at the bottom of the window shows you that the story has been created. You can click **Open** to access the story on the **Planning** page.

You can select several feedback items to create a story based on all of them.
You can select several feedback to create a story based on all of them.

### Managing Tags {#manage-tags}

Expand Down Expand Up @@ -269,7 +310,7 @@ You can receive a notification when new feedback lands in **Inbox** or when a re
* **Daily email update**
* **Weekly email update**

### Receiving Notifications for an Individual Feedback Item {#notifications-individual-feedback}
### Receiving Notifications for an Individual Feedback {#notifications-individual-feedback}

You can receive notifications for an individual feedback item. To set this up, click the {{% icon name="view-off" %}} icon in the upper-right corner of the **Feedback** tab after you open the feedback item.
You also automatically start receiving notifications for an individual feedback item once you respond to the reporter of the feedback or leave a comment for your team in the **Communications** section of the feedback details window.
You can receive notifications for an individual feedback. To set this up, click the {{% icon name="view-off" %}} icon in the upper-right corner of the **Feedback** tab after you open the feedback.
You also automatically start receiving notifications for an individual feedback once you respond to the reporter of the feedback or leave a comment for your team in the **Communications** section of the feedback details window.
6 changes: 6 additions & 0 deletions content/en/docs/releasenotes/developer-portal/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,12 @@ To see the current status of the Mendix Portal, see [Mendix Status](https://stat

## 2025

### October 30

#### New Features

* You can now group feedback for easier management. This new option is available by selecting feedback on the **Inbox** tab, then clicking **Group Items**. All resulting feedback groups within an app are listed on the new **Groups** tab of the [Feedback](/developerportal/app-insights/feedback/) page.

### October 26, 2025

#### Improvements
Expand Down
Loading