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

# Shared List

> Learn to create and share a Shared List for distributing HTTP rules with controlled access.

***

A Shared List is a convenient way to share HTTP rules using a single shareable link. You can create a Shared List for team collaboration or distribution while maintaining control over accessibility.

## Key Features of Shared Lists

* **Simple Sharing:** Share multiple rules via a single link.

* **Controlled Access:** Public or private options ensure flexibility in accessibility.

* **Static State:** Shared Lists share the current state of rules and **do not update** in real-time.

## Steps to Create a Shared List

<Steps>
  <Step title="Select Rules to Share">
    Go to HTTP Rules, and open "My Rules" from the left sidebar. Select the rules you want to share by using the checkboxes in the rules table.

    <img src="https://mintcdn.com/requestly/LX9nR6xxyL7F8mCE/images/shared-list/4edaf68f-8c87-4f2c-9a73-105ef41de319.png?fit=max&auto=format&n=LX9nR6xxyL7F8mCE&q=85&s=c79e5aa62dc7fc185c5ccfc3776e2fae" align="center" fullwidth="false" width="2400" height="1460" data-path="images/shared-list/4edaf68f-8c87-4f2c-9a73-105ef41de319.png" />
  </Step>

  <Step title="Open the Share Modal and Create Shared List">
    Click on the "Share" button in the toolbar above the rules table. In the "Shared List" tab of the Share modal, you can define the accessibility of the Shared List:

    1. **Public Shared List:** The link is automatically generated; just copy the link and share it with anyone to allow them to view and import the Shared List.

           <img src="https://mintcdn.com/requestly/LX9nR6xxyL7F8mCE/images/shared-list/ee1ae17f-6bda-4a35-837c-eda7775dfeee.png?fit=max&auto=format&n=LX9nR6xxyL7F8mCE&q=85&s=8047d798b79d19e94fa2485756e0e9d3" align="center" fullwidth="false" width="2400" height="1372" data-path="images/shared-list/ee1ae17f-6bda-4a35-837c-eda7775dfeee.png" />

    2. **Private Shared List:** Requires you to add specific email addresses for users who can view and import the Shared List. After entering the email IDs, click on "Create List." An email is sent to the user, and additionally, you can copy the generated link and share it with the person. They need to log in using the same email to import the Shared List.

           <img src="https://mintcdn.com/requestly/LX9nR6xxyL7F8mCE/images/shared-list/2976b253-e7e7-4130-b127-1517efaf913b.gif?s=f52291991e925ea3319c7f54f045be59" align="center" fullwidth="false" width="1200" height="675" data-path="images/shared-list/2976b253-e7e7-4130-b127-1517efaf913b.gif" />
  </Step>

  <Step title="Import notification">
    You can get the shared list import email when someone imports your shared list.

    <img src="https://mintcdn.com/requestly/LX9nR6xxyL7F8mCE/images/shared-list/d765b509-03ee-4c66-8982-812471a29e1b.gif?s=13017a2a664b351e4994aa1aa02448fb" align="center" fullwidth="false" width="724" height="500" data-path="images/shared-list/d765b509-03ee-4c66-8982-812471a29e1b.gif" />

    For existing shared lists, you can click on more options on shared list row and enable or disable it from there.

    <img src="https://mintcdn.com/requestly/LX9nR6xxyL7F8mCE/images/shared-list/79cbb6cd-00e2-4a96-922e-56900efd66d3.gif?s=8aa0fdac155808db3c7409e5b20bc372" align="center" fullwidth="false" width="1232" height="432" data-path="images/shared-list/79cbb6cd-00e2-4a96-922e-56900efd66d3.gif" />
  </Step>
</Steps>

## Steps to Import a Shared List

Importing a Shared List differs between the browser extension and the desktop app, with specific steps for each platform.

### Import in Browser Extension

<Steps>
  <Step title="Use the Shared List Link">
    If you have received a Shared List link, open it in your browser. Try opening <a target="_blank" href="https://app.requestly.io/rules#sharedList/6b827aed8bd44ec2af3391bbcfb54b55-requestly_shared_list_23_12_2024">this demo Shared List</a>.

    <img src="https://mintcdn.com/requestly/C-8RNowaOOgmOMj9/images/shared-list/1008ae41-4569-45a6-9d04-c5b187807b85.png?fit=max&auto=format&n=C-8RNowaOOgmOMj9&q=85&s=1c48c81bf378745a42bddc210244f096" align="center" fullwidth="false" width="2400" height="1508" data-path="images/shared-list/1008ae41-4569-45a6-9d04-c5b187807b85.png" />
  </Step>

  <Step title="Preview the Rules">
    Click on the `View` button to review the rules in the Shared List before importing.

    <img src="https://mintcdn.com/requestly/LX9nR6xxyL7F8mCE/images/shared-list/3a8926e5-db9a-48b6-88d0-107d7ced0297.png?fit=max&auto=format&n=LX9nR6xxyL7F8mCE&q=85&s=8f0d6512162e1135fbdd77010b9d8241" align="center" fullwidth="false" width="2400" height="1344" data-path="images/shared-list/3a8926e5-db9a-48b6-88d0-107d7ced0297.png" />
  </Step>

  <Step title="Import the Rules">
    Click on "Import to My Rules" to add the Shared List rules to your dashboard.

    <img src="https://mintcdn.com/requestly/LX9nR6xxyL7F8mCE/images/shared-list/ea95af42-9721-463b-b5cc-ac8a29e4e24e.png?fit=max&auto=format&n=LX9nR6xxyL7F8mCE&q=85&s=c79f1f1385979d4cab950351e6a38be0" align="center" fullwidth="false" width="2400" height="1344" data-path="images/shared-list/ea95af42-9721-463b-b5cc-ac8a29e4e24e.png" />
  </Step>
</Steps>

### Import in Desktop App

<Steps>
  <Step title="Open SharedList Importer">
    Go to HTTP Rules, and open "Shared List" from the left sidebar. Click "Import from URL."
  </Step>

  <Step title="Review and Import the Shared List">
    Paste the Shared List link into the input box. Click "Import Rules from this list" to view the Shared List content. Review the rules and click "Import to My Rules" to add them to your dashboard.
  </Step>
</Steps>

<Warning>
  Unlike sharing in workspaces, Shared Lists do not reflect real-time updates. To collaborate with live updates, consider using the "Share in Workspace" feature.
</Warning>
