<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 15.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "GroupActivities",
  "identifier" : "/documentation/GroupActivities/GroupSessionEvent/Action-swift.struct/QueueChange",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Group Activities",
      "GroupActivities"
    ],
    "preciseIdentifier" : "s:15GroupActivities0A12SessionEventV6ActionV11QueueChangeV"
  },
  "title" : "GroupSessionEvent.Action.QueueChange"
}
-->

# GroupSessionEvent.Action.QueueChange

A type that describes a modification to the playback queue.

```
struct QueueChange
```

## Overview

Use this type to inform the participant about changes to the playback
queue associated with the current activity. Your app manages the queue,
along with any additions or changes. You use this type to communicate those
changes back to the participant using the system UI.

When a change occurs, configure this type with information about the change,
and wrap it in a [`GroupSessionEvent.Action`](/documentation/GroupActivities/GroupSessionEvent/Action-swift.struct) type. Pass the
action to the [`showNotice(_:)`](/documentation/GroupActivities/GroupSession/showNotice(_:)) method to display the change
to the participant.

## Topics

### Specifying the type of change

[`static func added(GroupSessionEvent.Action.QueueChange.Item) -> GroupSessionEvent.Action.QueueChange`](/documentation/GroupActivities/GroupSessionEvent/Action-swift.struct/QueueChange/added(_:))

Returns a queue change for an added item.

[`static func setUpNext(GroupSessionEvent.Action.QueueChange.Item) -> GroupSessionEvent.Action.QueueChange`](/documentation/GroupActivities/GroupSessionEvent/Action-swift.struct/QueueChange/setUpNext(_:))

Returns a queue change for a new up-next item.

### Getting the changed item

[`struct Item`](/documentation/GroupActivities/GroupSessionEvent/Action-swift.struct/QueueChange/Item)

Detailed information about an item involved in a queue change.


---

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)