<!--
{
  "availability" : [
    "iOS: 17.2.0 -",
    "iPadOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "JournalingSuggestions",
  "identifier" : "/documentation/JournalingSuggestions",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "Journaling Suggestions"
    ],
    "preciseIdentifier" : "JournalingSuggestions"
  },
  "title" : "Journaling Suggestions"
}
-->

# Journaling Suggestions

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

## 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.

![A figure that features two iPhone device frames in an app workflow progressing from left to right. The frame at left depicts several photos, including one of a flower, in a thumbnail view under text that reads Highlights from Photo Memories. A callout below reads Suggestions picker. The frame at right depicts a detailed version of the flower thumbnail below user-defined text that reads Coastal Hike.  Bars below the image represent a person’s writing above a callout that reads Journal entry.](images/com.apple.JournalingSuggestions/JournalingSuggestions@2x.png)

To incorporate a suggestions picker ([`JournalingSuggestionsPicker`](/documentation/JournalingSuggestions/JournalingSuggestionsPicker)) in your app, declare it using <doc://com.apple.documentation/documentation/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

  <doc://com.apple.documentation/documentation/Updates/JournalingSuggestions>

[Presenting the suggestions picker and processing a selection](/documentation/JournalingSuggestions/presenting-the-suggestions-picker-and-processing-a-selection)

Display the journaling suggestions picker and process a suggestion that someone chooses.

  <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.journal.allow>

### Implementation

[`JournalingSuggestionsPicker`](/documentation/JournalingSuggestions/JournalingSuggestionsPicker)

A view that lists different types of recent events in a person’s life.

[`JournalingSuggestion`](/documentation/JournalingSuggestions/JournalingSuggestion)

High-level information about a suggestion that a person chooses in the journaling suggestions picker.

[`JournalingSuggestionAsset`](/documentation/JournalingSuggestions/JournalingSuggestionAsset)

An interface for the content that the suggestions picker presents.

### Notifications

[Receiving journaling suggestions system notifications](/documentation/JournalingSuggestions/receiving-journaling-suggestions-from-system-notifications)

Register your app to receive journaling suggestions when a person taps a system notification.

[`JournalingSuggestionPresentationToken`](/documentation/JournalingSuggestions/JournalingSuggestionPresentationToken)

A container for a Journaling Suggestion identifier.

[`JournalingSuggestionsConfiguration`](/documentation/JournalingSuggestions/JournalingSuggestionsConfiguration)

The configuration for Journaling Suggestion notifications.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)