Twitch Merch Train

A Merch Train is a “hype train” for merch: when purchases hit certain intervals on stream, it automatically dishes out rewards to everyone watching. Below you’ll learn how to connect, configure, and embed Merch Train in your Twitch stream.

1. Prerequisites

• You need an active Fourthwall store.

• A Twitch account with streaming software (OBS, Streamlabs OBS, etc.).

• Twitch Merch Train app installed in your Fourthwall dashboard (under Apps → Twitch Merch Train).

2. Connect Your Channel

1. Go to Apps → Twitch Merch Train in your Fourthwall dashboard.

2. If you haven’t connected yet, click Connect.

3. You'll go through two prompts, one to connect your Fourthwall data, the next to connect Twitch.

4. Once authorized, the banner will change to Connected.

5. To revoke at any time, click Disconnect.

3. Enable & Configure

Once connected, toggle Enable Merch Train during streams on to unlock the settings below:

a. Train Timer Duration

• What it does: Every time someone buys merch, the train timer resets. When the timer finally runs out, the train ends and the counter resets to zero.

• How to set: Enter your preferred duration (in minutes).

  • Example: 2 minutes

b. Reward Threshold

• What it does: Defines how many total orders must happen before the reward is triggered.

• How to set: Check Set how many units… and enter a number.

  • Example: 3 orders

c. Reward Product

• What it does: The item you give away when the train hits your threshold.

• How to set: Click Change product, then select any item from your catalog.

• Note: You will be charged the cost of the product on giveaway redemption.

d. (Optional) Filter by Collection

• What it does: Only counts purchases of products in a specific collection towards the merch train.

• How to set:

  1. Create a new collection (optional if you want to use an existing collection) for the filter.

  2. Check Filter by collection.

  3. Select one of your store’s collections from the dropdown.

  4. Add / remove products you want from that collection

4. Embedding the Widget

To show Merch Train on your stream:

1. Copy the Widget URL at the bottom of the settings page.

2. In OBS (or your software of choice), add a new Browser source.

3. Paste the URL as the source URL.

4. Set your desired Width & Height—the widget is responsive, so you can pick any size that fits your layout.

Pro Tip: To change the look and feel of the widget, you can use CSS overrides in your OBS software

.counter-label { color: red; font-size: 16px; }

.counter { ... }

.gifts-label { ... }

.gifts { ... }

.timer-icon { ... }

.timer