> ## Documentation Index
> Fetch the complete documentation index at: https://learn.social.plus/llms.txt
> Use this file to discover all available pages before exploring further.

# Feed Video Auto-play

> Play video, clip and live posts in place, muted, as members scroll their feeds — with a network switch and a personal setting for members

> [!NOTE]
>
> **Key Benefit**: When feed videos wait for a tap, members scroll past them as thumbnails, and the feed feels static next to the social apps they use every day. With auto-play on, the most visible video plays in place, muted, so members can judge a video in a second or two without being caught out by sound. Your video and live posts get watched instead of scrolled past, and one tap takes members into the full player, already playing, with no feed or player code to write.

> [!NOTE]
>
> **Platform Support**: Feed video auto-play is available on the **iOS, Android and React Web** UIKit: Android UIKit 4.35.0 and Web UIKit 4.28.0 or later. It is not available on Flutter or React Native.

## Feature Overview

Feed video auto-play is built into the UIKit's post components. Once it's turned on for your network, every supported feed plays videos automatically: there is nothing to add to your screens. Members can choose when it runs for themselves, and it can be turned off for the whole network at any time.

> [card] Plays in place
>
> The most visible video starts as soon as it is at least half on screen, muted. One video plays at a time.

> [card] One sound setting
>
> Videos start muted. One unmute applies to every later video in the session, including the full player.

> [card] Resume and replay
>
> Each video resumes where it stopped. It plays once and ends on its last frame with **Watch again**.

> [card] Member control
>
> Members choose when auto-play runs. The network switch applies to everyone.

## How It Works

Auto-play runs only when **both** of these allow it. Neither one outranks the other: if either is off, nothing auto-plays.

| Control | Who sets it | Default |
| - | - | - |
| **Network switch** | social.plus Support, on request ([Turn It On for Your Network](#turn-it-on-for-your-network)) | **Off** |
| **Member setting** | Each member, in their own profile menu ([Member setting](#member-setting)) | **On** |

When both allow it, the UIKit behaves like this:

| Situation | What members see |
| - | - |
| A video is at least half on screen and nothing else is playing | It plays muted, at once |
| The playing video drops below half | The most visible video takes over |
| The member unmutes | Every later video in the session plays with sound, including the full player. Logout, closing or restarting the app, a page reload or a new tab starts muted again. |
| A clip was posted muted | It always plays muted. Its sound button shows muted and does nothing. |
| Music or other audio plays in another app (Android, iOS) | A muted video lets it keep playing. The app takes the audio only after the member unmutes. |
| The member taps a playing video | The full player opens, already playing from the same point |
| A video ends | Its dimmed last frame with **Watch again**; it doesn't loop |
| The member scrolls back to a video | It resumes from where it stopped |
| A sheet, menu or the full player covers the feed, or the app or tab goes to the background | The video pauses, then resumes from the same point |
| Playback fails, or auto-play can't run (switch off, member setting off, offline) | The thumbnail and play button |

Feed previews of live and recorded live posts are **not counted** as views, and the member does not join the host's viewer list. Counting starts when the member opens the live player.

### Where Auto-play Runs

| Auto-plays | Shows the thumbnail and play button |
| - | - |
| Global and For You feeds, community feeds (including pinned and announcement posts), the community **Pin** tab, user feeds, event discussions, post detail | Search results, pending posts, community **Videos** and **Livestream** tabs, media galleries |

Video, clip, live and recorded live posts all auto-play, including videos inside a carousel: swiping to a video page plays it.

## Turn It On for Your Network

Auto-play is off by default. To turn it on for your network, contact [social.plus Support](https://ekoapp.atlassian.net/servicedesk/customer/portal/3). Members' apps pick up the change the next time they sign in or the app starts.

## Member Setting

Members open **their own profile → ⋯ menu → Settings → Autoplay in feed**. The row shows the current choice. Visitors and bots don't see the row and always count as on.

| Platform | Opens as | Choices |
| - | - | - |
| Android, iOS | A bottom sheet over the profile menu | **on Wi-Fi and mobile data** · **on Wi-Fi only** · **Never** |
| React Web | The **Autoplay in feed** page, with a description | An **On/Off** switch |

* A choice is saved as soon as it's made. On Android and iOS, tapping outside the sheet closes it.
* With nothing saved, auto-play is on: **on Wi-Fi and mobile data** on Android and iOS, **On** on Web.
* The choice is saved on the device (in the browser on Web), not per user. It carries over to whoever signs in next on that device or browser.
* On Android and iOS, Data Saver (Android) and Low Data Mode (iOS) also stop auto-play.
* The network switch off overrides any member choice.

> [!NOTE]
>
> Web offers a single On/Off switch because browsers can't reliably tell Wi-Fi from mobile data. Web doesn't check the connection type or the browser's data saver, so **On** auto-plays on any connection.

### Web: The Setting Page with Your Own Navigation

If your web app passes `onChangePage` to `AmityUiKitProvider` to handle navigation itself, the **Autoplay in feed** row sends `{ type: 'AutoplaySettingPage' }` instead of opening the page. Render `AmityAutoplaySettingPage` for that type. It takes no props.

```tsx React theme={null}
import { useState } from 'react';
import { AmityUiKitProvider, AmityAutoplaySettingPage } from '@amityco/ui-kit';

function App() {
  const [page, setPage] = useState<{ type: string } | null>(null);

  return (
    <AmityUiKitProvider
      /* your existing apiKey, apiRegion, userId and other props */
      onChangePage={(next) => setPage(next)}
    >
      {page?.type === 'AutoplaySettingPage' ? <AmityAutoplaySettingPage /> : <YourCurrentScreen />}
    </AmityUiKitProvider>
  );
}
```

Without `onChangePage`, the UIKit opens the page itself and you don't need any code.

## Customization

Feed video auto-play has no config IDs on Android or iOS, and none for the feed video on Web: the video, its sound button and **Watch again** can't be hidden or themed through config, so auto-play can't be turned off for a single screen. To turn it off for your network, contact [social.plus Support](https://ekoapp.atlassian.net/servicedesk/customer/portal/3).

The Web setting page has a page ID, like other Web pages:

| Config ID | Type | Description |
| - | - | - |
| `autoplay_setting_page/*/*` | Page | You can customize the page theme (Web only) |
| `autoplay_setting_page/*/back_button` | Element | You can customize the back button icon (Web only) |
| `autoplay_setting_page/*/title` | Element | You can customize the title text (Web only) |

## Troubleshooting

> [accordion] Videos don't auto-play
>
> 1. Check with [social.plus Support](https://ekoapp.atlassian.net/servicedesk/customer/portal/3) that auto-play is turned on for your network.
> 2. Members pick up a change only at their next session: sign out and back in, or restart the app.
> 3. Check the member's own setting in **profile → ⋯ → Settings → Autoplay in feed**.
> 4. On Android and iOS, check Data Saver or Low Data Mode, and **on Wi-Fi only** while on mobile data.
> 5. Check that the screen is one where auto-play runs ([Where auto-play runs](#where-auto-play-runs)).

> [accordion] Web: every video shows a play button
>
> Some browsers block auto-play entirely (for example Safari with **Never Auto-Play**, or Firefox with **Block Audio and Video**). When the browser refuses even muted playback, auto-play stays off for the session and every video shows its play button until the page reloads.

> [accordion] Web: the first video plays muted after the member turned sound on
>
> Some browsers won't play sound without a fresh tap. The video then plays muted and its sound button shows muted; the member's next tap turns the sound back on.

## Related Components

> [card] [Social Feeds](https://learn.social.plus/uikit/components/social/feeds.md)
>
> The feeds and home page where auto-play runs.

> [card] [Video Post (SDK)](https://learn.social.plus/social-plus-sdk/social/content-management/posts/creation/video-post.md#read-the-auto-play-setting)
>
> Read the auto-play setting when you build your own video UI.

> [card] [Localization](https://learn.social.plus/uikit/customization/localization.md)
>
> Override UIKit text, including auto-play's, in any language.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.