# Commands -  Subscribing

## <kbd>/subscribe</kbd>

The subscribe command is used for subscribing to individual parts within a channel, meaning that the next time a deal is found by the bot for that part, it will be posted to the channel.

{% hint style="info" %}
This command must be ran from within the channel where you'd like the deals to be posted
{% endhint %}

Optionally a price you believe is a good deal for the part can be specified. The advantage of using the centrally managed price is that it is continually monitored and tweaked so that as the market slowly drops for parts as they age, deals are not increasingly posted (otherwise its not really a good deal).

#### Parameters

* `part_name` (Required) - the part you would like to subscribe to e.g. rtx 4060, ryzen 5 5600X.
* `desired_price` (Optional) - the price at which you'd like deals to show for the part, if left blank it will use the centrally configured price for that part, which is managed in the CS Computers Discord Server.
* `role` (Optional) - the role that you would like pinged for deals that are posted. This will use a default value assigned centrally if not specified. This does not automatically create the role for you, this must be done manually.

#### Examples

<figure><img src="https://1345900575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqHys5NCNU0JPtHnK114%2Fuploads%2FEm3d0BmToviievjSrbBy%2Fimage.png?alt=media&#x26;token=c9c96650-f995-4124-a67e-4ed0fda6cf04" alt=""><figcaption><p>Example without specifying a price</p></figcaption></figure>

<figure><img src="https://1345900575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqHys5NCNU0JPtHnK114%2Fuploads%2FPjrQmN87y9KzMLjW5Pg1%2Fimage.png?alt=media&#x26;token=fa7f69f1-3395-4e62-bfcd-34bf7fb99a4c" alt=""><figcaption><p>Example where a server-specific price is specified</p></figcaption></figure>

## <kbd>/subscribe-group</kbd>

The subscribe group command is used for subscribing to a collection of parts that have been setup centrally by CS Computers. This will still work even if you are already subscribed to some parts in the group, and parts will automatically subscribed within the channel if a part is later added to the group.

{% hint style="info" %}
This command must be ran from within the channel where you'd like the deals to be posted
{% endhint %}

<figure><img src="https://1345900575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqHys5NCNU0JPtHnK114%2Fuploads%2FnAyPJQlh7p70JVGzVZYu%2Fimage.png?alt=media&#x26;token=c176cf75-38bd-478b-8da2-09357065c2fc" alt=""><figcaption><p>Part Groups Example List</p></figcaption></figure>

#### Parameters

* `group_name` (Required) - the part group that you would like to subscribe to, all subscriptions will go into the channel you run the command in
* `role` (Optional) - the role that you would like pinged for all posted deals that are in the group. A default role is set otherwise that is associated to the group, these roles can be found [here](https://cs-computers.gitbook.io/docs/ebay-parts-watcher/part-groups)

#### Examples

<figure><img src="https://1345900575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqHys5NCNU0JPtHnK114%2Fuploads%2FnWmqeQUF6G3eHoiChO0K%2Fimage.png?alt=media&#x26;token=d87da17e-4977-4221-8d44-ee7537fd9673" alt=""><figcaption><p>Example of subscribing to a group</p></figcaption></figure>

## <kbd>/unsubscribe</kbd>

The unsubscribe command is used for removing a part from your server's subscriptions, meaning the deals will no longer be posted in the channel. This command works even if you are subscribed to a group, only the part specified will be removed.

{% hint style="info" %}
This command can be ran from any channel and have the same effect
{% endhint %}

#### Parameters

* `part_name` - the part you'd like to unsubscribe from.

#### Examples

<figure><img src="https://1345900575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqHys5NCNU0JPtHnK114%2Fuploads%2FHq2XPsp2l0rOkOJEL0KH%2Fimage.png?alt=media&#x26;token=557ddfbd-7045-464e-9e9b-85c3af8348d2" alt=""><figcaption><p>Example of unsubscribing from a part</p></figcaption></figure>

## <kbd>/unsubscribe-group</kbd>

The unsubscribe group command is used for removing an entire group of parts from your server's subscriptions, meaning all the deals will no longer be posted in the channel, or whatever channel the individual parts were set to post into.&#x20;

This will remove parts regardless if they have been altered beyond the standard setup from the group and simply goes through all parts in the part group, and removes them from your server's subscriptions.

{% hint style="info" %}
This command can be ran from any channel and have the same effect
{% endhint %}

## <kbd>/list-subscriptions</kbd>&#x20;

The list subscriptions command gives you a interactive GUI message that you can use to see all of the subscriptions active in your server, what channel they post into, and any custom configuration including the role or desired price. If you are utilising the default role and price for a part, it will show up as N/A. An example of this can be seen below:

<figure><img src="https://1345900575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVqHys5NCNU0JPtHnK114%2Fuploads%2FiqzfHQeKixhV34upOEAO%2Fimage.png?alt=media&#x26;token=67dd0e66-6674-459e-8653-b4de2109d651" alt=""><figcaption><p>List subscriptions preview</p></figcaption></figure>
