## Setting Up macOS Text Replacement for Jam Recording Links

This guide shows you how to set up a macOS text replacement so that typing `/jam` in any input field instantly expands into your Jam Recording Link. No switching tabs, no copy-pasting.

### 1. Generate a Recording Link
Use the Jam extension or dashboard to generate a [Recording Link](/content/s/recording-links/index.html). Name it “General feedback” or whatever you like, and copy the link.

### 2. Open Text Replacements in macOS
Go to **System Settings → Keyboard → Text Replacements**.

### 3. Add the replacement
Click **+**. Enter `/jam` in the **Replace** field and paste the link in the **With** field.

You can pre-fill the Jam’s title by adding `?jam-title=` to the query string. For example: `https://recorder.jam.dev/QrBnf3s?jam-title=Shopping+cart+bug`.

### 4. Save the shortcut
Click **Add**, then **Done**.

### 5. Use /jam anywhere
You’re all set. Now, in any text input on your Mac, type `/jam` followed by a **Space** or **Return**. macOS will automatically replace it with your Recording Link. Anyone who receives the link can click it to record and send you a Jam directly. Here are a few ways to use it:

- **Slack**: Type `/jam` in a message to a member or in a support channel: _“Seeing something weird? `/jam`. Use this to record what you’re experiencing.”_
- **Customer support**: Paste it into a Zendesk, Intercom, or Freshdesk reply: _“Could you record what’s happening using this link? `/jam`”_
- **Email**: Drop it into a support or feedback email to a user.
- **Linear / Jira / Notion**: Add it to a ticket or doc to ask someone to record a reproduction of a bug.
- **Onboarding flows**: Send it to new users so they can show you where they’re getting stuck.

You can create multiple text replacements for different contexts. For example, use `/jam-bug` for a bug-report link with a pre-filled title and `/jam-feedback` for a general feedback link.