* 442 delete 'doc' folder to replace with updated Markdown files (see next commit) * 442 add 'docs' direcotory replacing custom Markdown links with standard ones
4.5 KiB
id | revision | language | title |
---|---|---|---|
355 | 0 | en | Set up your community permissions |
:::info Currently, you can only customize community permissions using Status desktop. :::
In Status Communities, owners can customize community permissions using tokens. Tokens are digital assets in a blockchain (such as the Ethereum blockchain), including virtual coins, collectibles and domain names.
Once you set up token-based permissions, certain actions within your community are only available to users who own a particular token. For instance, owners can restrict access to their community or delegate admin functions to specific token holders.
:::info In Status, your tokens are securely stored in your Status Wallet. :::
What to expect
- Using token-based permissions, community owners can restrict community access and actions to specific people based on token requirements.
- Only the community owner can add, edit or delete community-level permissions.
- You set up community permissions in the same way you set up channel permissions. The only difference is the permissions you grant, either community-level (Become admin or Become member) or channel-level (Moderate, View and post or View only).
- Use the Become member permission to restrict access to your community. Use the Become admin permission to delegate admin functions to someone.
Add community permissions
Community owners customize permissions using three different variables: Who holds
(optional), Is allowed to
and In
. For each variable, follow the same procedure using the table below for reference.
=== "Desktop"
1. From the navigation sidebar, click your community.
1. On top of the channel sidebar, click your community logo and then, click **Permissions**.
1. Click **Add permission** to start from scratch or click :desktop-duplicate: **Duplicate** to start from an existing permission.
1. For the `Who holds`, `Is allowed to` and `In` variables, click :desktop-plus: **Add** next to the variable and choose your values. Use the table below for reference.
1. Optionally, check :desktop-hide: **Hide permission** to hide this permission from members who don't meet the requirements.
1. Click **Create permission**. The new permission takes effect immediately.
| Variable | Description | Options |
|:--------------|:-------------------------------------------------------------------------------|:--------------------------------------|
| `Who holds` (optional) | The tokens and amounts (for assets and collectibles) someone needs to hold. | Assets, Collectibles, ENS |
| `Is allowed to` | The community role that you assign to someone. | :desktop-admin: Become admin, :desktop-member: Become member |
| `In` | The community this permission applies to. | Community |
- If you turn the **Who holds** option off, the permission isn't bound to a token. This option only applies to channel-level permissions.
- Tokens are linked by `AND` operators. This means the new permission takes effect when the holder owns all the tokens. If you want to use the `OR` operator instead, create additional permissions.
- You can include up to five tokens in a single permission.
- You can create a maximum of five different Become member community-level permissions.
Edit community permissions
=== "Desktop"
1. From the navigation sidebar, click your community.
1. On top of the channel sidebar, click your community logo and then, click **Permissions**.
1. In the permission you want to edit, click :desktop-edit: **Edit**.
1. To customize the permission, follow the steps in the [Add community permissions](#add-community-permissions) section.
Delete community permissions
=== "Desktop"
1. From the navigation sidebar, click your community.
1. On top of the channel sidebar, click your community logo and then, click **Permissions**.
1. In the permission you want to delete, click :desktop-delete: **Delete**.
1. Click **Delete permission** to confirm your action.