Notifications display brief information that is surfaced from the bottom right of VS Code.
You can send three types of notifications:
It's important to limit the number of notifications sent in order to respect the user's attention. To help guide your decision on whether or not you should show a notification, please follow our notification decision tree:
This notification appears after the user runs an Update version command. Notice that there are no additional actions and is purely informational.
This example highlights an issue with a feature that requires user input and shows actions to resolve the issue.
This example shows a failure notification with an action to resolve the issue.
- Respect the user's attention by only sending notifications when absolutely necessary
- Add a Do not show again option for every notification
- Show one notification at a time
- Send repeated notifications
- Use for promotion
- Ask for feedback on the first install
- Show actions if there aren't any
When needing to display progress for an indeterminate timeframe (for example, setting up an environment), you can use the progress notification. This type of global progress notification should be used as a last resort as progress is best kept within context (within a view or editor).
- Show a link to see more details (like logs)
- Show information as setup progresses (initializing, building, etc.)
- Provide an action to cancel the operation (if applicable)
- Add timers for timed out scenarios
- Leave a notification running in progress
This example uses the progress notification to show the setup involved for a remote connection, while also providing a link to the output logs (details).