# Pins
## Overview
Sometimes you'll want to pin your favorite activity to a feed. You can pin an activity like this:
```swift
let activity = client.activity(
for: "activity_123",
in: FeedId(group: "user", id: "john")
)
// Pin an activity
try await activity.pin()
// Unpin an activity
try await activity.unpin()
```
```kotlin
val activity = client.activity(
activityId = "activity_123",
fid = FeedId(group = "user", id = "john")
)
// Pin an activity
activity.pin()
// Unpin an activity
activity.unpin()
```
```js
// Pin an activity
client.pinActivity({
feed_group_id: feed.group,
feed_id: feed.id,
activity_id: "activity_123",
});
// Unpin an activity
client.unpinActivity({
feed_group_id: feed.group,
feed_id: feed.id,
activity_id: "activity_123",
});
```
```js
// Pin an activity
client.pinActivity({
feed_group_id: feed.group,
feed_id: feed.id,
activity_id: "activity_123",
});
// Unpin an activity
client.unpinActivity({
feed_group_id: feed.group,
feed_id: feed.id,
activity_id: "activity_123",
});
```
```js
// Pin an activity
client.pinActivity({
feed_group_id: feed.group,
feed_id: feed.id,
activity_id: "activity_123",
});
// Unpin an activity
client.unpinActivity({
feed_group_id: feed.group,
feed_id: feed.id,
activity_id: "activity_123",
});
```
```dart
final activity = client.activity(
activityId: 'activity_123',
fid: const FeedId(group: 'user', id: 'john'),
);
// Pin an activity
await activity.pin();
// Unpin an activity
await activity.unpin();
```
```js
// Pin an activity
client.feeds.pinActivity({
feed_group_id: feed.group,
feed_id: feed.id,
activity_id: "activity_123",
user_id: "",
});
// Unpin an activity
client.feeds.unpinActivity({
feed_group_id: feed.group,
feed_id: feed.id,
activity_id: "activity_123",
user_id: "",
});
```
```go
_, err = client.Feeds().PinActivity(context.Background(), feedGroupID, feedID, activityID, &getstream.PinActivityRequest{
UserID: getstream.PtrTo("john"),
})
if err != nil {
log.Fatal("Error pinning activity:", err)
}
```
```java
PinActivityRequest pinRequest = PinActivityRequest.builder().userID(testUserId).build();
PinActivityResponse response = testFeed.pinActivity(activityId, pinRequest).getData();
```
```php
$activityId = 'activity_123';
$feedGroupId = 'user';
$feedId = 'eric';
$response = $feedsClient->pinActivity(
$feedGroupId,
$feedId,
$activityId,
new GeneratedModels\PinActivityRequest(userID: "eric")
);
```
```csharp
var response = await _feedsV3Client.PinActivityAsync(
"user",
_testFeedId,
activityId,
new PinActivityRequest
{
UserID = _testUserId
}
);
```
```python
response = self.test_feed.pin_activity(activity_id, user_id=self.test_user_id)
```
```ruby
require 'getstream_ruby'
client = GetStreamRuby.manual(
api_key: 'api_key',
api_secret: 'api_secret'
)
# Pin an activity
pin_request = GetStream::Generated::Models::PinActivityRequest.new(
user_id: 'john'
)
pin_response = client.feeds.pin_activity('user', 'john', 'activity_123', pin_request)
```
When you read a feed pinned activities are automatically returned:
```swift
try await feed.getOrCreate()
print(feed.state.pinnedActivities)
```
```kotlin
feed.getOrCreate()
feed.state.pinnedActivities.collect { pinData ->
println(pinData)
}
```
```js
const response = await feed.getOrCreate();
console.log(response.pinned_activities);
```
```js
const response = await feed.getOrCreate();
console.log(response.pinned_activities);
```
```js
const response = await feed.getOrCreate();
console.log(response.pinned_activities);
```
```dart
await feed.getOrCreate();
print(feed.state.pinnedActivities);
```
```js
const response = await feed.getOrCreate({ user_id: "sara" });
console.log(response.pinned_activities);
```
```go
_, err = client.Feeds().UnpinActivity(context.Background(), feedGroupID, feedID, activityID, &getstream.UnpinActivityRequest{
UserID: getstream.PtrTo("john"),
})
if err != nil {
log.Fatal("Error unpinning activity:", err)
}
```
```java
UnpinActivityRequest unpinRequest = UnpinActivityRequest.builder().UserID(testUserId).build();
UnpinActivityResponse response = testFeed.unpinActivity(activityId, unpinRequest).getData();
```
```php
$activityId = 'activity_123';
$feedGroupId = 'user';
$feedId = 'eric';
$response = $feedsClient->unpinActivity(
$feedGroupId,
$feedId,
$activityId,
'eric'
);
```
```csharp
var response = await _feedsV3Client.UnpinActivityAsync(
"user",
_testFeedId,
activityId,
new { user_id = _testUserId }
);
```
```python
response = self.test_feed.unpin_activity(activity_id, self.test_user_id)
```
```ruby
require 'getstream_ruby'
client = GetStreamRuby.manual(
api_key: 'api_key',
api_secret: 'api_secret'
)
# Unpin an activity
unpin_response = client.feeds.unpin_activity('user', 'john', 'activity_123', 'john')
```
---
This page was last updated at 2026-03-10T10:48:21.523Z.
For the most recent version of this documentation, visit [https://getstream.io/activity-feeds/docs/javascript/pins/](https://getstream.io/activity-feeds/docs/javascript/pins/).