> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameUiSetNotificationPositionHint

> XGameUiSetNotificationPositionHint

# XGameUiSetNotificationPositionHint

Sets the preferred position for toast notifications to be shown on the current title.

## Syntax

```cpp theme={null}
HRESULT XGameUiSetNotificationPositionHint(  
         XGameUiNotificationPositionHint position  
)  
```

### Parameters

*position*   \_In\_\
Type: [XGameUiNotificationPositionHint](/reference/system/xgameui/enums/xgameuinotificationpositionhint)

Indicates the preferred position to display toast notifications on the current title.

### Return value

Type: HRESULT

## Remarks

<Note>This function isn't safe to call on a time-sensitive thread. For more information, see [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

The notification position is a hint to the operating system on where to display toast notifications. In some cases, the system may choose to ignore the setting if the current UI cannot support displaying notifications in that location. By default on XBOX, toast notifications are shown at the bottom center of the screen.

This API exists on Windows, however it currently has no effect on achievement and other toast notifications.

## Requirements

**Header:** XGameUI.h

**Library:** xgameruntime.lib

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

## Conceptual documentation

* [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## See also

[XGameUI](/reference/system/xgameui/xgameui_members)\
[XGameUiNotificationPositionHint](/reference/system/xgameui/enums/xgameuinotificationpositionhint)


## Related topics

- [XGameUiNotificationPositionHint](/reference/system/xgameui/enums/xgameuinotificationpositionhint.md)
- [XGameUI](/reference/system/xgameui/xgameui_members.md)
- [XGameUiTextEntryPositionHint](/reference/system/xgameui/enums/xgameuitextentrypositionhint.md)
- [XGameUiTextEntryUpdatePositionHint](/reference/system/xgameui/functions/xgameuitextentryupdatepositionhint.md)
- [XSpeechToTextSetPositionHint](/reference/system/xaccessibility/functions/xspeechtotextsetpositionhint.md)