<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "SharedWithYou",
  "identifier" : "/documentation/SharedWithYouCore",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "Shared with You Core"
    ],
    "preciseIdentifier" : "SharedWithYouCore"
  },
  "title" : "Shared with You Core"
}
-->

# Shared with You Core

Integrate custom collaboration with Messages, Mail, and FaceTime.

## Overview

The Shared with You Core framework provides classes to collaborate and share documents directly with the Messages, Mail, and FaceTime apps. Use the classes in this framework to share content, create configurable collaboration settings, and manage participants.

The framework provides a customizable popover to your app to manage details of the collaboration and connect to conversations. The UI incorporates technologies you already use, like share sheet and drag and drop. An indicator in the share sheet header identifies a collaboration.

Use the [`SWCollaborationCoordinator`](/documentation/SharedWithYouCore/SWCollaborationCoordinator) to manage collaboration activities in your app. The [`SWCollaborationMetadata`](/documentation/SharedWithYouCore/SWCollaborationMetadata) objects contain the collaboration metadata with essential information like, identifiers, titles, and share option configuration that update the UI. To customize collaboration settings, use the [`SWCollaborationOption`](/documentation/SharedWithYouCore/SWCollaborationOption), [`SWCollaborationOptionsGroup`](/documentation/SharedWithYouCore/SWCollaborationOptionsGroup), and [`SWCollaborationShareOptions`](/documentation/SharedWithYouCore/SWCollaborationShareOptions) classes. These options appear in Messages, Mail, and FaceTime, providing people with the opportunity to make choices about permissions, access levels, and other collaboration parameters.

For more information on integrating with Messages, Mail, and FaceTime, see <doc://com.apple.sharedwithyou/documentation/SharedWithYou/adding-custom-collaboration-to-your-app>.

> Note: Shared with You Core is a <doc://com.apple.sharedwithyou/documentation/SharedWithYou> framework.

## Topics

### Coordinate collaborations

[`SWCollaborationCoordinator`](/documentation/SharedWithYouCore/SWCollaborationCoordinator)

An object that contains the shared collaboration coordinator.

### Handle collaboration actions

[`SWAction`](/documentation/SharedWithYouCore/SWAction)

An object that represents a collaboration action.

[`SWCollaborationActionHandler`](/documentation/SharedWithYouCore/SWCollaborationActionHandler)

A delegate to handle incoming collaboration actions from a collaboration coordinator.

[`SWStartCollaborationAction`](/documentation/SharedWithYouCore/SWStartCollaborationAction)

An object that represents the first action sent to an app when the user shares a collaboration.

[`SWUpdateCollaborationParticipantsAction`](/documentation/SharedWithYouCore/SWUpdateCollaborationParticipantsAction)

An action that contains the cryptographic identities the system uses to add to or remove from an existing collaboration.

### Register the collaboration metadata

[`SWCollaborationMetadata`](/documentation/SharedWithYouCore/SWCollaborationMetadata)

A model object for conveying data during a collaboration.

### Manage options in a collaboration

[`SWCollaborationOption`](/documentation/SharedWithYouCore/SWCollaborationOption)

An object that determines how the system shares a document in a collaboration.

[`SWCollaborationOptionsGroup`](/documentation/SharedWithYouCore/SWCollaborationOptionsGroup)

An object that represents a group of collaboration options that the system displays together.

[`SWCollaborationOptionsPickerGroup`](/documentation/SharedWithYouCore/SWCollaborationOptionsPickerGroup)

An object that represents a group of collaboration options that the system displays together with mutually exclusive options.

[`SWCollaborationShareOptions`](/documentation/SharedWithYouCore/SWCollaborationShareOptions)

An object that represents the state of the collaboration options for the document.

[`SWLocalCollaborationIdentifier`](/documentation/SharedWithYouCore/SWLocalCollaborationIdentifier)

A local identifier for a collaboration.

[`UTCollaborationOptionsTypeIdentifier`](/documentation/SharedWithYouCore/UTCollaborationOptionsTypeIdentifier)

A string constant for the options type identifier.

### Manage collaboration participants

[`SWPerson`](/documentation/SharedWithYouCore/SWPerson)

An object that tracks participants in a collaboration.

[`SWCollaborationIdentifier`](/documentation/SharedWithYouCore/SWCollaborationIdentifier)

A unique identifier for a collaboration.

### Track collaboration version information

[`SharedWithYouCoreVersionNumber`](/documentation/SharedWithYouCore/SharedWithYouCoreVersionNumber)

Project version number for Shared with You Core.

[`SharedWithYouCoreVersionString`](/documentation/SharedWithYouCore/SharedWithYouCoreVersionString)

Project version string for Shared with You Core.


---

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)