How to contribute to Journaling Suggestions?

Apple's new Journal app was introduced with the iOS 17.2 beta.

In the release notes, the following is mentioned:

If your app donates activities or interactions to SiriKit or CallKit or if someone authorizes your app to save data to HealthKit, some data might show up as part of Journaling Suggestions.

Is there any documentation on how this works exactly? What kind of activities can be featured in Journal? How does the system decide what to feature?

For instance, if I have an app that allows the user to create art images, can I somehow make those images appear in the Journaling Suggestions?

Replies

Some docs on HealthKit and donating Shortcuts. There's some callouts to Journal in there. If your app donates activities or interactions to SiriKit or HealthKit, the item donated may be shown in any app that utilizes Journaling Suggestions. You can't necessarily directly choose to feature/donate a specific thing, only important events will be aggregated into a Journaling Suggestion.

Take a look at this doc on permissions and sharing for 3rd party apps: https://www.apple.com/legal/privacy/data/en/journaling-suggestions/