---
title: Journaling Suggestions
framework: Journaling Suggestions
role: collection
role_heading: Framework
platforms: [iOS 17.2+, iPadOS 26.0+]
path: journalingsuggestions
---

# Journaling Suggestions

Display a set of recent, personal events that inspire someone to contribute to your app’s creative workflow.

## Overview

Overview Journaling Suggestions provides a visual picker interface for iPhone apps. The picker displays personal events that occur in someone’s life, such as a place they visited, a person they connected with, a photo in their library, or a song that they play repeatedly. If your app facilitates personal writing, display the picker to provide people with ideas for their creative content. When someone chooses a suggestion from the picker, the system makes high-level details about the event available to your app. For example, a journaling app uses the details to display the beginning of a new journal entry about the selected suggestion.

To incorporate a suggestions picker (JournalingSuggestionsPicker) in your app, declare it using SwiftUI, and choose the text for a button that presents the picker. For the picker to appear, your app needs a special entitlement in your app’s code signature. You don’t need to ask for additional authorization because your app can’t access the details for a suggestion until after a person chooses to share them by making a selection in the picker. note: Mac apps built with Mac Catalyst ignore input if someone taps a suggestions picker button.

## Topics

### Essentials

- [Journaling Suggestions updates](updates/journalingsuggestions.md)
- [Presenting the suggestions picker and processing a selection](journalingsuggestions/presenting-the-suggestions-picker-and-processing-a-selection.md)
- [com.apple.developer.journal.allow](bundleresources/entitlements/com.apple.developer.journal.allow.md)

### Implementation

- [JournalingSuggestionsPicker](journalingsuggestions/journalingsuggestionspicker.md)
- [JournalingSuggestion](journalingsuggestions/journalingsuggestion.md)
- [JournalingSuggestionAsset](journalingsuggestions/journalingsuggestionasset.md)

### Notifications

- [Receiving journaling suggestions system notifications](journalingsuggestions/receiving-journaling-suggestions-from-system-notifications.md)
- [JournalingSuggestionPresentationToken](journalingsuggestions/journalingsuggestionpresentationtoken.md)
- [JournalingSuggestionsConfiguration](journalingsuggestions/journalingsuggestionsconfiguration.md)