# Following Feeds

Following relationships are a fundamental part of social networks and many other apps that feature feeds. They link one Feed to another and cause Activities added to a feed to appear in any other feeds that follow it.

When an Activity is added to a feed, it is automatically added to any other feeds that follow the feed. This does not propagate further through the graph of following relationships. If your app requires that the Activity be added to other feeds, ["to" field targeting](/activity-feeds/docs/node/v2/targeting/) or a [batch activity add](/activity-feeds/docs/node/v2/add_many_activities/) may be suitable.

The code example below shows you how to follow a feed:

<codetabs>

<codetabs-item value="csharp" label="C#">

```csharp
// timeline:timeline_feed_1 follows user:user_42
var timelineFeed1 = client.Feed("timeline", "timeline_feed_1");
await timelineFeed1.FollowFeedAsync("user", "user_42");

// follow feed without copying the activities:
await timelineFeed1.FollowFeedAsync("user", "user_42", 0);
```

</codetabs-item>

<codetabs-item value="javascript" label="JavaScript">

```js
// timeline:timeline_feed_1 follows user:user_42:
await timeline_feed_1.follow("user", "user_42");

// Follow feed without copying the activities:
await timeline_feed_1.follow("user", "user_42", { limit: 0 });
```

</codetabs-item>

<codetabs-item value="python" label="Python">

```python
# timeline:timeline_feed_1 follows user:user_42
timeline_feed_1.follow("user", "user_42")

# Follow feed without copying the activities
timeline_feed_1.follow("user", "user_42", activity_copy_limit=0)
```

</codetabs-item>

<codetabs-item value="ruby" label="Ruby">

```ruby
# timeline:timeline_feed_1 follows user:user_42
timeline_feed_1 = client.feed('timeline', 'timeline_feed_1')
timeline_feed_1.follow('user', 'user_42')

# follow feed without copying the activities:
timeline_feed_1.follow('user', 'user_42', activity_copy_limit=0)
```

</codetabs-item>

<codetabs-item value="php" label="PHP">

```php
// timeline:timeline_feed_1 follows user:user_42
$timeline1 = $client-&gt;feed('timeline', 'timeline_1');
$timeline1-&gt;follow('user', 'user_42');

// follow feed without copying the activities:
$timeline1-&gt;follow('user', 'user_42', 0)
```

</codetabs-item>

<codetabs-item value="java" label="Java">

```java
// timeline:timeline_feed_1 follows user:user_42
FlatFeed user = client.flatFeed("user", "user_42");
FlatFeed timeline = client.flatFeed("timeline", "timeline_feed_1");
timeline.follow(user);

// follow feed without copying the activities:
timeline.follow(user, 0);
```

</codetabs-item>

<codetabs-item value="go" label="Go">

```go
// timeline:timeline_feed_1 follows user:user_42
	userFeed, err := client.FlatFeed("user", "user_42")
	if err != nil {
		panic(err)
	}

	timeline, err := client.FlatFeed("timeline", "timeline_feed_1")
	if err != nil {
		panic(err)
	}

	_, err = timeline.Follow(context.TODO(), userFeed)
	if err != nil {
		panic(err)
	}

	// follow feed without copying all the activities:
	_, err = timeline.Follow(context.TODO(), userFeed, stream.WithFollowFeedActivityCopyLimit(20))
	if err != nil {
		panic(err)
	}
```

</codetabs-item>

</codetabs>

Also take note that:

<admonition type="info">

Only Flat Feeds may be followed

</admonition>

<admonition type="warning">

A Feed cannot follow itself

</admonition>

By default, the most recent 100 existing activities in the target feed will be added to the follower feed, but this can be changed via the  `activity_copy_limit`  parameter.

### Parameters

| name                | type   | description                                                         | default | optional |
| ------------------- | ------ | ------------------------------------------------------------------- | ------- | -------- |
| feed                | string | The feed id                                                         | -       |          |
| target              | string | The feed id of the target feed                                      | -       |          |
| activity_copy_limit | int    | How many activities should be copied from the target feed. max 1000 | -       | ✓        |

If you need to follow many feeds at once have a look at how to [batch follow](#batch-follow) later in this document. If you need to run large imports, use our [JSON import format](/activity-feeds/docs/node/v2/importing_data_feeds/).

## Unfollowing Feeds

Unfollowing a feed removes the following relationship with the feed specified in the target parameter. See the following examples:

<codetabs>

<codetabs-item value="csharp" label="C#">

```csharp
var timelineFeed1 = client.Feed("timeline", "timeline_feed_1");

// stop following feed user_42
await timelineFeed1.UnfollowFeedAsync("user", "user_42");

// stop following feed 42 but keep history of activity
```

</codetabs-item>

<codetabs-item value="javascript" label="JavaScript">

```js
// Stop following feed user_42 - purging history:
await timeline_feed_1.unfollow("user", "user_42");

// Stop following feed user_42 but keep history of activities:
await timeline_feed_1.unfollow("user", "user_42", { keepHistory: true });
```

</codetabs-item>

<codetabs-item value="python" label="Python">

```python
# Stop following feed user_42
timeline_feed_1.unfollow("user", "user_42")

# Stop following feed user_42 but keep history of activities
timeline_feed_1.unfollow("user", "user_42", keep_history=True)
```

</codetabs-item>

<codetabs-item value="ruby" label="Ruby">

```ruby
# Stop following feed user_42
timeline_feed_1.unfollow('user', 'user_42')

# Stop following feed 42 but keep history of activities
timeline_feed_1.unfollow('user', 'user_42', keep_history=true)
```

</codetabs-item>

<codetabs-item value="php" label="PHP">

```php
// Stop following feed user_42
$timelineFeed1-&gt;unfollow('user', 'user_42');

// Stop following feed user_42 but keep history of activities:
$timelineFeed1-&gt;unfollow('user', 'user_42', true);
```

</codetabs-item>

<codetabs-item value="java" label="Java">

```java
// Stop following feed user:user_42
timeline.unfollow(user);

// Stop following feed user:user_42 but keep history of activities
timeline.unfollow(user, KeepHistory.YES);
```

</codetabs-item>

<codetabs-item value="go" label="Go">

```go
// Stop following feed user:user_42
	_, err = timeline.Unfollow(context.TODO(), userFeed)
	if err != nil {
		panic(err)
	}

	// Stop following feed user:42 but keep history of activities
	_, err = timeline.Unfollow(context.TODO(), userFeed, stream.WithUnfollowKeepHistory(true))
	if err != nil {
		panic(err)
	}
```

</codetabs-item>

</codetabs>

Existing Activities in the feed that originated in a no longer followed target feed will be purged unless the `keep_history` parameter is provided.

### Parameters

| name         | type    | description                                                        | default | optional |
| ------------ | ------- | ------------------------------------------------------------------ | ------- | -------- |
| feed         | string  | The feed id                                                        | -       |          |
| target       | string  | The feed id of the target feed                                     | -       |          |
| keep_history | boolean | Whether the activities from the unfollowed feeds should be removed | false   | ✓        |

<admonition type="info">

Re-following a feed that is already followed has no effect. However, unfollowing and re-following a feed will result in feed updates as Activities are purged and re-added to the feed.

</admonition>

## Reading Feed Followers

Returns a paginated list of the given feed's followers. See the following example:

<codetabs>

<codetabs-item value="csharp" label="C#">

```csharp
await userFeed1.FollowersAsync(0, 10);
```

</codetabs-item>

<codetabs-item value="javascript" label="JavaScript">

```js
// List followers
const response = await user1.followers({ limit: "10", offset: "10" });
```

</codetabs-item>

<codetabs-item value="python" label="Python">

```python
# list followers
user_feed_1.followers(offset=0, limit=10)
```

</codetabs-item>

<codetabs-item value="ruby" label="Ruby">

```ruby
# list followers
user_feed_1.followers(0, 10)
```

</codetabs-item>

<codetabs-item value="php" label="PHP">

```php
// list followers
$userFeed1-&gt;followers(0, 10);
```

</codetabs-item>

<codetabs-item value="java" label="Java">

```java
// list followers
List<followrelation> followers = userFeed.getFollowers(new Limit(10), new Offset(0)).get();
for (FollowRelation follow : followers) {
  System.out.format("%s -&gt; %s", follow.getSource(), follow.getTarget());
  // ...
 }</followrelation>
```

</codetabs-item>

<codetabs-item value="go" label="Go">

```go
resp, err := userFeed.GetFollowers(
 context.TODO(),
 stream.WithFollowersOffset(0),
 stream.WithFollowersLimit(10),
)
for _, follower := range resp.Results {
 fmt.Println(follower.FeedID, "-->", follower.TargetID)
		// ...
}
```

</codetabs-item>

</codetabs>

The followers returned by the API are sorted reverse chronologically, according to the time the follow relationship was created.

<admonition type="info">

The number of followers that can be retrieved is limited to 1,000.

</admonition>

### Parameters

| name   | type    | description                                              | default | optional |
| ------ | ------- | -------------------------------------------------------- | ------- | -------- |
| limit  | integer | Amount of results per request, max 100                   | 25      | ✓        |
| offset | integer | Number of rows to skip before returning results, max 999 | 0       | ✓        |

### Response Data

<codetabs>

<codetabs-item value="json" label="JSON">

```json
{
  "results": [
    {
      "feed_id": "conversation2:test",
      "target_id": "conversation2:user_2",
      "created_at": "2018-01-19T09:35:17.817332Z"
    }
  ],
  "duration": "1.92ms"
}
```

</codetabs-item>

</codetabs>

## Reading Followed Feeds

Returns a paginated list of the feeds which are followed by the feed. See the following example:

<codetabs>

<codetabs-item value="csharp" label="C#">

```csharp
// Retrieve last 10 feeds followed by userFeed1
await userFeed1.FollowingAsync(0, 10);

// Retrieve 10 feeds followed by userFeed1 starting from the 11th
await userFeed1.FollowingAsync(10, 10);

// Check if user1 follows specific feeds
await userFeed1.FollowingAsync(0, 2, new[] { "user:42", "user:43" })
```

</codetabs-item>

<codetabs-item value="javascript" label="JavaScript">

```js
// Retrieve last 10 feeds followed by user_feed_1
let response = await user1.following({ offset: 0, limit: 10 });

// Retrieve 10 feeds followed by user_feed_1 starting from the 11th
response = await user1.following({ offset: 10, limit: 10 });

// Check if user1 follows specific feeds
response = await user1.following({
  offset: 0,
  limit: 2,
  filter: ["user:42", "user:43"],
});
```

</codetabs-item>

<codetabs-item value="python" label="Python">

```python
# Retrieve last 10 feeds followed by user_feed_1
user_feed_1.following(offset=0, limit=10)

# Retrieve 10 feeds followed by user_feed_1 starting from the 11th
user_feed_1.following(offset=10, limit=10)

# Check if user_feed_1 follows specific feeds
user_feed_1.following(offset=0, limit=2, feeds=['user:42', 'user:43'])
```

</codetabs-item>

<codetabs-item value="ruby" label="Ruby">

```ruby
# Retrieve 10 feeds followed by user_feed_1
user_feed_1.following(0, 10)

# Retrieve 10 feeds followed by user_feed_1 starting from the 11th
user_feed_1.following(10, 10)

# Check if user_feed_1 follows specific feeds
user_feed_1.following(0, 2, filter=['user:42', 'user:43'])
```

</codetabs-item>

<codetabs-item value="php" label="PHP">

```php
// Retrieve 10 feeds followed by $userFeed1
$userFeed1-&gt;following(0, 10);

// Retrieve 10 feeds followed by $userFeed1 starting from the 10th (2nd page)
$userFeed1-&gt;following(10, 10);

// Check if $userFeed1 follows specific feeds
$userFeed1-&gt;following(0, 2, ['user:42', 'user:43']);
```

</codetabs-item>

<codetabs-item value="java" label="Java">

```java
// Retrieve last 10 feeds followed by user_feed_1
List<followrelation> followed = userFeed.getFollowed(new Limit(10), new Offset(0)).get();

// Retrieve 10 feeds followed by user_feed_1 starting from the 11th
followed = userFeed.getFollowed(new Limit(10), new Offset(10)).get();

// Check if user_feed_1 follows specific feeds
followed = userFeed.getFollowed(new Limit(2), new Offset(0), new FeedID("user:42"), new FeedID("user", "43")).get();</followrelation>
```

</codetabs-item>

<codetabs-item value="go" label="Go">

```go
// Retrieve last 10 feeds followed by user_42
	resp, err := userFeed.GetFollowing(
		context.TODO(),
		stream.WithFollowingOffset(0),
		stream.WithFollowingLimit(10),
	)
	if err != nil {
		panic(err)
	}
	for _, r := range resp.Results {
		fmt.Println(r)
		//...
	}

	// Retrieve 10 feeds followed by user_42 starting from the 11th
	resp, err = userFeed.GetFollowing(
		context.TODO(),
		stream.WithFollowingOffset(10),
		stream.WithFollowingLimit(10),
	)
	if err != nil {
		panic(err)
	}

	// Check if user_42 follows specific feeds
	resp, err = userFeed.GetFollowing(
		context.TODO(),
		stream.WithFollowingOffset(0),
		stream.WithFollowingLimit(2),
		stream.WithFollowingFilter("user:user_43", "user:user_44"),
	)
	if err != nil {
		panic(err)
	}
```

</codetabs-item>

</codetabs>

The followed feeds returned by the API are sorted reverse chronologically, according to the time the follow relationship was created.

<admonition type="info">

The number of followed feeds that can be retrieved is limited to 1,000.

</admonition>

### Parameters

| name   | type    | description                                              | default | optional |
| ------ | ------- | -------------------------------------------------------- | ------- | -------- |
| limit  | integer | Amount of results per request, max 100                   | 25      | ✓        |
| offset | integer | Number of rows to skip before returning results, max 999 | 0       | ✓        |
| filter | string  | The comma-separated list of feeds to filter results on   | -       | ✓        |

### Response Data

<codetabs>

<codetabs-item value="json" label="JSON">

```json
{
  "results": [
    {
      "feed_id": "conversation2:test",
      "target_id": "conversation2:user_2",
      "created_at": "2018-01-19T09:35:17.817332Z",
      "updated_at": null
    }
  ],
  "duration": "1.92ms"
}
```

</codetabs-item>

</codetabs>

## Reading follow stats

Paginating followers and/or followings is sometimes not the answer and only counts are needed. In this case, stats can be retrieved directly too. With default permissions, it works automatically for server side auth. For client-side auth, please contact support to add it to your required feed groups.

<admonition type="warning">

Counts are up to 10K. If a feed has more followers or followings than this number, please contact support to increase limits.

</admonition>

<codetabs>

<codetabs-item value="javascript" label="JavaScript">

```js
// get follower and following stats of the feed
client.feed("user", "me").followStats();

// get follower and following stats of the feed but also filter with given slugs
// count by how many timelines follow me
// count by how many markets are followed
client.feed.followStats({
  followerSlugs: ["timeline"],
  followingSlugs: ["market"],
});
```

</codetabs-item>

<codetabs-item value="python" label="Python">

```python
# get follower and following stats of the feed but also filter with given slugs
# count by how many timelines follow me
# count by how many markets are followed
response = client.follow_stats(feed_id, follower_slugs=["timeline"], following_slugs=["market"])
```

</codetabs-item>

<codetabs-item value="ruby" label="Ruby">

```ruby
# get follower and following stats of the feed but also filter with given slugs
# count by how many timelines follow me
# count by how many markets are followed
timeline_feed_1 = client.feed('user', 'me')
stats = timeline_feed_1.follow_stats(followers_slugs = ['user'], following_slugs = ['user'])
```

</codetabs-item>

</codetabs>

### Response Data

<codetabs>

<codetabs-item value="json" label="JSON">

```json
{
  "results": {
    "followers": { "count": 1529, "feed": "user:me" },
    "following": { "count": 81, "feed": "user:me" }
  },
  "duration": "1.92ms"
}
```

</codetabs-item>

</codetabs>


---

This page was last updated at 2026-03-04T14:18:42.200Z.

For the most recent version of this documentation, visit [https://getstream.io/activity-feeds/docs/go-golang/v2/following/](https://getstream.io/activity-feeds/docs/go-golang/v2/following/).