# Join/Leave Community

## Join Community

The `join()` function works by adding the active user as a member of the specified community. By becoming a member of a community within your app, users can connect with like-minded individuals and build deeper relationships within the community. 

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/9c59ae1824a7e3c5b2844e2f43569f92>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/amythee/630f229a7fd7196f24bc165d2f5f59c5#file-amitycommunityjoin-kt>" %}
{% endtab %}

{% tab title="JavaScript" %}
{% embed url="<https://gist.github.com/amythee/780c0b61e4a8d3f5c0a25c09e2e8273e#file-joincommunity-js>" %}
{% endtab %}

{% tab title="TypeScript" %}
{% embed url="<https://gist.github.com/amythee/fa4bd7be302f34eccbf98801d5d26c5b#file-joincommunity-ts>" %}
{% endtab %}

{% tab title="Flutter" %}
{% embed url="<https://gist.github.com/amythee/f60a5504a5be1b390bc125f515444fc9#file-amitycommunityjoin-dart>" %}
{% endtab %}
{% endtabs %}

## Network-Level Membership Settings

Your network can be configured with different membership acceptance modes:

* Automatic membership (default): Users become members immediately when added
* Invitation acceptance: Users receive an invitation and must explicitly accept before joining

## Community Types and Join Behavior

### Public Communities

* Doesn't require approval: Users can join immediately by calling `joinCommunity`
* **Requires approval**: Users must submit a join request and wait for moderator approval

### Private & Visible Communities

* Discoverable in search and explore pages
* Content is hidden from non-members
* Typically requires moderator approval to join

### **Private & Hidden Communities**

* Not discoverable by non-members
* Content is hidden from non-members
* Requires moderator approval to join

To join a community, you simply need to call `join()` method present in Community object. If a community requires moderator approval, the join process creates a request instead of immediate membership:

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/9c59ae1824a7e3c5b2844e2f43569f92>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/amythee/9ce33b70c59b243d9f4f184d0553fa16>" %}
{% endtab %}

{% tab title="TypeScript" %}
{% embed url="<https://gist.github.com/fa4bd7be302f34eccbf98801d5d26c5b>" %}
{% endtab %}
{% endtabs %}

### Managing Join Requests

#### For Users

**Check Join Request Status**

Users can check the status of their submitted join requests:

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/f9e191c5fe2643bb006edb0925f4ff7b>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/amythee/d184df37b602c818dcf86d528a0ec09f>" %}
{% endtab %}

{% tab title="TypeScript" %}
{% embed url="<https://gist.github.com/amythee/7e138ceb513bb8981b20cc33a51962d1>" %}

{% endtab %}
{% endtabs %}

**Cancel Join Request**

Users can cancel pending join requests:

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/585e4328c8ff1ad7d7acbccb5bf3c666>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/amythee/3f6371ffc41377bbde6cfcb3f9272cf6>" %}
{% endtab %}

{% tab title="TypeScript" %}
{% embed url="<https://gist.github.com/amythee/abf1695217ba10671b26b30740089d85>" %}

{% endtab %}
{% endtabs %}

#### For Moderators

**Get Pending Requests**

Moderators can retrieve all pending join requests for their communities:

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/a507d68df65b79b5fd0e74204cac3328>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/amythee/09ce8dc102158e391c56951f2a30d1db>" %}
{% endtab %}

{% tab title="TypeScript" %}
{% embed url="<https://gist.github.com/amythee/326bac0f0476a72ca13f06c7406092c9>" %}
{% endtab %}
{% endtabs %}

Approve Join Request

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/90ed853a993a4eefa10cf84a62a553bb>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/amythee/a1eb68600063851dc9d4cbd499d84d46>" %}
{% endtab %}

{% tab title="TypeScript" %}
{% embed url="<https://gist.github.com/amythee/26afad1a13bb29a0e59600a895dff676>" %}
{% endtab %}
{% endtabs %}

Reject Join Request

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/a3cee061dcf00fd0f04549f974e403ad>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/amythee/e0beb5592bddc2971f708697bca5954c>" %}
{% endtab %}

{% tab title="TypeScript" %}
{% embed url="<https://gist.github.com/amythee/dc428af4973be6ed63baf57df2de8800>" %}
{% endtab %}
{% endtabs %}

## Leave Community

The `leaveCommunity` function works by removing the active user as a member of the specified community. This removes the user's access to the community feed and disables their ability to post messages or participate in community discussions. To leave a community, you simply need to pass the specific community ID as a parameter of the `leaveCommunity` function.

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/d4adcc6a5d1855232726efc0f4c7096f>" %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/amythee/24d739ed747bcf54b00db1ed1d99f4ee#file-amitycommunityleave-kt>" %}
{% endtab %}

{% tab title="JavaScript" %}
{% embed url="<https://gist.github.com/amythee/4d5c555edfb8d0bbeba60fd530d7eeee#file-leavecommunity-js>" %}
{% endtab %}

{% tab title="TypeScript" %}
{% embed url="<https://gist.github.com/amythee/ae5a91de54e1221c2a992a61dba9bb78#file-leavecommunity-ts>" %}
{% endtab %}

{% tab title="Flutter" %}
{% embed url="<https://gist.github.com/amythee/2327681b1e0674e477fe1967bdbbaa57#file-amitycommunityleave-dart>" %}
{% endtab %}
{% endtabs %}