# Creators

Run your city's creators program on Discord, with levels, roles, applications, the /creator command and automatic post counting.

Source: https://fivedash.fivex.gg/docs/en/discord/creators

Streamers and video creators bring the city to more people. With **Creators**, you run a program for them: each creator gets a role and a level, joins through the `/creator` command or an application on Discord, and every post in the promotion channel is counted automatically in the panel. The team follows who's promoting, reviews applications and changes levels from FiveDash.

## Before you start

* **Plan:** the plan must include the **Discord** module at the **Pro** tier or above. On Plus, the page only shows a preview of the feature, with an invite to change plans.
* **Bot connected:** the city's bot must be set up and inside the Discord server. See [Bot](https://fivedash.fivex.gg/docs/en/discord/bot).
* **Roles on Discord:** create the creator role first (and, if you want, one role per level). The bot's role must be **above** these roles to give and take them.
* **Promotion channel:** the bot must be able to change this channel's permissions to open it to the creator role. If it can't, the panel warns: "the bot needs “Manage Channel” on it".
* **Message Content Intent:** without it, posts are counted, but their text and links don't show in **Latest posts**.
* **Access level** (in **Settings → Members**, area **Creators**):

| Level         | What it allows                                                                          |
| ------------- | --------------------------------------------------------------------------------------- |
| **View**      | Creators, posts and applications (numbers, list, sheets and settings in read-only mode) |
| **Manage**    | Approve applications, change levels and remove creators (also bring them back)          |
| **Configure** | Levels, roles, channels, form and messages; saving and publishing the application panel |

The menu is **Discord → Creators** (`/<org>/<server>/discord/criadores`). The page has the tabs **Overview**, **Creators**, **Applications**, **Form** and **Settings**.

> The `/creator` command on Discord doesn't depend on FiveDash access. Who can use the command is set by Discord roles in **Who uses /creator**, in the settings (see below).

## Set up the program

### Open the settings

Go to **Discord → Creators** and click the **Settings** tab.

### Pick the role and the channel

Under **Program**, pick the **Creator role** (every creator gets it) and the **Promotion channel** (where creators post).

### Choose who uses /creator

Under **Who uses /creator**, pick the team roles that can add, remove and change creators' levels. With no roles, it stays **Administrators only**.

### Build the levels

Under **Levels**, set each level's name, color, role and description, from the first (entry) to the top. Use **Add level** to create more.

### Turn it on and save

At the top of the page, turn on **Turn creators on** (the switch shows **On**) and click **Save** in the bar at the bottom.

On save, the creator role gets access to view, send messages, embed links and attach files in the promotion channel. If the bot lacks permission, you see the warning "Saved, but something didn't change on Discord".

## Add creators

A member joins the program in three ways:

| Source (in the sheet)      | How                                                                                  |
| -------------------------- | ------------------------------------------------------------------------------------ |
| **Through /creator**       | Someone on the team uses `/creator adicionar` on Discord                             |
| **Through an application** | The member applies through the panel on Discord and the team approves it in FiveDash |
| **Through the panel**      | Someone brings back, from FiveDash, a creator who had been removed                   |

On joining, the member gets the **Creator role** and the level's role and, with **On joining the program** on, a welcome DM.

### The /creator command

The command and option names are in Portuguese in every language.

| Subcommand           | Options                                                                                                                 | What it does                                                                  |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| `/creator adicionar` | `membro` (required), `nivel` (optional; unset, the first level), `canal` (optional, channel link, up to 300 characters) | Adds the member to the program, or changes the level of someone already in it |
| `/creator remover`   | `membro` (required), `motivo` (optional, goes in the DM, up to 500 characters)                                          | Removes the creator access and the roles                                      |
| `/creator nivel`     | `membro` (required), `nivel` (required)                                                                                 | Changes the level of a creator already in the program                         |

The `nivel` option suggests the program's levels as you type. The bot's reply is private (only whoever used it sees it).

**Who can use it:** administrators and anyone with **Manage Server** on Discord always can. Besides them, anyone with one of the roles in **Who uses /creator**. The program must be on.

| Bot reply                                                                    | Why                                             |
| ---------------------------------------------------------------------------- | ----------------------------------------------- |
| "The creator program is turned off in the panel."                            | **Turn creators on** is off                     |
| "You don't have one of the roles that can use /creator."                     | The person doesn't have any of the picked roles |
| "Only administrators can use /creator until a role is allowed in the panel." | No role picked in **Who uses /creator**         |
| "Bots can't join the creator program."                                       | The chosen member is a bot                      |
| "A role wasn't given: the bot's role must be above the creator roles."       | Role hierarchy on Discord                       |
| "The DM didn't go through (the member has DMs closed)."                      | The member doesn't accept DMs from the server   |

## Applications

### Turn applications on

In **Settings → Applications**, turn on **Accept applications** and pick the **Panel channel** (the panel stays pinned there).

### Notify the team (optional)

In **Notify the team on Discord**, pick a channel where each new application arrives with the “Ver no painel” button, and in **Mention roles** the roles to mention. With **Panel only**, applications stay only in FiveDash.

### Build the form

In the **Form** tab, set the window title, the intro and the questions.

### Save to publish

Click **Save**. The panel is published in the channel ("Application panel published"). Use **View panel**, at the top of the page, to open the message on Discord.

On Discord, the member clicks the panel's button, fills in the window and right away gets the **Right after submitting** message (only they see it). The bot doesn't open the window when:

* the member is already a creator;
* they already have an application waiting for the team;
* they were refused and the **Apply again after being refused** wait hasn't passed;
* applications are off.

### Review an application

### Open the application

In the **Applications** tab (the number next to it shows how many are waiting), filter by **Waiting**, **Approved** or **Refused** and click the application. The “Ver no painel” button on the Discord notice also opens it directly.

### Approve

Click **Approve**, pick the **Starting level**, write a **Note (optional)** and confirm with **Approve as creator**. The member joins with the roles right away.

### Or refuse

Click **Refuse**, write the **Reason for refusing (optional)** and confirm with **Refuse application**. The reason goes in the DM (as `{motivo}`) and in the log.

When approving, the first link found in the answers becomes the creator's channel. The team's notice on Discord is updated with the decision, and the sheet shows the **Timeline** (sent, notice posted, approved or refused, DM delivered).

## Follow and manage creators

### Overview

| Block                       | What it shows                                                   |
| --------------------------- | --------------------------------------------------------------- |
| **Posts**                   | Posts in the last 7 days, compared with the previous 7 days     |
| **Creators in the program** | Active creators, and how many joined in the last 30 days        |
| **Applications waiting**    | How many are waiting for the team (click to review)             |
| **Inactive**                | Creators with no posts in 14 days or more                       |
| **Posts per day**           | Everything creators posted in the channel over the last 30 days |
| **Levels**                  | How many active creators in each level                          |
| **Monthly ranking**         | Who posted the most in the last 30 days                         |
| **Latest posts**            | What just arrived in the channel, with **View in Discord**      |

Only messages from active creators in the **Promotion channel** count. If a message is deleted, it stops counting.

### Creators list

In the **Creators** tab, filter by level (or **All** and **Removed**), search by name, ID or channel link, and sort by **Most posts this month**, **Most posts overall**, **Joined most recently** or **Inactive the longest**.

| Column         | What it shows                                     |
| -------------- | ------------------------------------------------- |
| **Creator**    | Name and the channel given                        |
| **Level**      | The current level                                 |
| **14 days**    | Posts per day over the last 14 days               |
| **This month** | Posts in the last 30 days (and the overall total) |
| **Last post**  | When they last posted                             |

### Creator sheet

Click a creator to open the sheet with the numbers (**This month**, **This week**, **Overall**, **Last 14 days**), since when they've been in the program, where they came from and their channel.

| Action                  | How                                                                                                                                     | Level      |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
| Change the level        | Under **Level**, pick another and click **Change**                                                                                      | **Manage** |
| Remove from the program | Click **Remove from program**, write the **Reason (optional)** and confirm. The creator roles are removed and the reason goes in the DM | **Manage** |
| Bring back              | On a removed creator, pick the level in **Bring back as** and click **Bring back**                                                      | **Manage** |

> Levels don't go up on their own. The team changes the level from the sheet or with `/creator nivel`, looking at the numbers in **Overview**.

## Settings

### Program

| Field                                    | What it does                                                                                                      | Default                 |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------- |
| **Turn creators on** (switch at the top) | Turns the program on. When on, a role and a channel are required                                                  | Off                     |
| **Creator role**                         | Every creator gets it. It's the role that opens the promotion channel                                             | None                    |
| **Promotion channel**                    | Where creators post. On save, the creator role gets access to view and send messages in it                        | None                    |
| **Who uses /creator**                    | Roles that add, remove and change creators' levels. Administrators and server managers always can. Up to 25 roles | **Administrators only** |

### Levels

From the first (entry) to the top. Each level can give its own role, which is taken away when the creator changes level. Up to 10 levels.

| Field                                   | What it does                                                                 | Default                                                                 |
| --------------------------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| Level name                              | Shows on Discord and in the panel. Required, no repeats, up to 40 characters | Iniciante, Parceiro, Elite (Rookie, Partner, Elite for an English city) |
| Color                                   | The level's color (used in the welcome DM)                                   | Green, blue, yellow                                                     |
| Level role                              | Extra role for this level. Can't be the same as the **Creator role**         | None                                                                    |
| Description                             | What this level means (optional), up to 200 characters                       | A sample text on each level                                             |
| **Move level up** / **Move level down** | Changes the order                                                            | —                                                                       |
| **Remove level**                        | Deletes the level; its creators move to the first level                      | —                                                                       |

> Changing a level's role doesn't update the people already at that level. Their roles follow the change the next time their level changes.

### Applications

| Field                               | What it does                                                               | Default        |
| ----------------------------------- | -------------------------------------------------------------------------- | -------------- |
| **Accept applications**             | A pinned panel on Discord with the button that opens the application form  | Off            |
| **Panel channel**                   | Where the application panel stays pinned. Required with applications on    | None           |
| **Notify the team on Discord**      | Channel where each new application arrives with the “Ver no painel” button | **Panel only** |
| **Mention roles**                   | Roles mentioned on each new application. Up to 25                          | **Nobody**     |
| **Apply again after being refused** | How long someone refused waits: **Right away**, 7, 14, 30 or 60 days       | 14 days        |

### Direct messages

| Field                               | What it does                                                          | Default |
| ----------------------------------- | --------------------------------------------------------------------- | ------- |
| **On joining the program**          | The creator gets a welcome with their level and the promotion channel | On      |
| **On leaving the program**          | Whoever is removed gets the notice with the reason                    | On      |
| **When the application is refused** | The applicant gets the result with the reason                         | On      |

### Discord log

| Field           | What it does                                                                      | Default        |
| --------------- | --------------------------------------------------------------------------------- | -------------- |
| **Log channel** | Every new creator, level change, departure and application becomes a message here | **Panel only** |

## Application form

The **Form** tab uses the same editor as [Forms](https://fivedash.fivex.gg/docs/en/discord/forms): the window's **Title** and **Intro (optional)** and the list of **Fields**. Discord shows up to 5 items in the window, and the intro, if it has text, takes one of them. Title up to 45 characters.

Field types: **Short text**, **Long text**, **Single choice**, **Multiple choice**, **Dropdown**, **Confirmation**, **Server member** and **Files**.

The default form (title **Creator application**) comes with:

| Question                                                                    | Type              |
| --------------------------------------------------------------------------- | ----------------- |
| Where do you create content? (Twitch, YouTube, TikTok, Kick, Instagram)     | **Single choice** |
| Link to your channel                                                        | **Short text**    |
| How many followers do you have? (Up to 500, 500 to 2K, 2K to 10K, Over 10K) | **Dropdown**      |
| What content do you make about the city? (at least 30 characters)           | **Long text**     |
| Program rules ("I've read and accept the creator rules")                    | **Confirmation**  |

The default texts, levels and questions follow the city's language.

## Customization

In the right column of **Settings** there's a Discord preview (**Panel**, **Window**, **Team**, **Member**, **Log**) and two shortcuts under **Customization**, each with **Restore default**.

### Messages

Click **Messages** to open **Customize messages**. The tabs are **Panel**, **On submit**, **Accepted**, **Refused** and **Removed**.

| Tab           | Field                                  | What it does                                                               | Default                                                                                                         |
| ------------- | -------------------------------------- | -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Panel**     | **Title**                              | The panel's title, up to 256 characters                                    | Become a city creator                                                                                           |
| **Panel**     | **Text**                               | The panel's text, up to 2000 characters                                    | An invite for streams, videos and clips                                                                         |
| **Panel**     | **Button**                             | The button that opens the application, up to 80 characters                 | I want to be a creator                                                                                          |
| **Panel**     | **Button emoji**                       | The button's emoji                                                         | `{{answer}}` (emoji pack icon)                                                                                  |
| **Panel**     | **Button color**                       | **Blue**, **Gray**, **Green** or **Red**                                   | **Blue**                                                                                                        |
| **Panel**     | **Image**                              | Optional. Wide (2:1), at the end of the panel                              | None                                                                                                            |
| **On submit** | **Right after submitting**             | Only the applicant sees it, right away                                     | `{{success}} Application sent, {membro}! The team will check out your channel and you'll get the answer by DM.` |
| **Accepted**  | **DM on joining the program**          | Sent when the application is approved or someone uses `/creator adicionar` | Welcome with `{servidor}`, `{nivel}` and `{canal}`                                                              |
| **Accepted**  | **Image**                              | Optional. Wide (2:1), at the end of the DM                                 | None                                                                                                            |
| **Refused**   | **DM when the application is refused** | `{motivo}` is what the team wrote when refusing                            | Notice with `{servidor}` and `{motivo}`                                                                         |
| **Removed**   | **DM on leaving the program**          | Sent on `/creator remover` or when the team removes them from the panel    | Notice with `{servidor}` and `{motivo}`                                                                         |

Messages take up to 1500 characters. Images: PNG, JPG, WebP or GIF up to 1 MB. With applications on, the panel needs a title or text.

#### Variables

The variable names stay in Portuguese in every language.

| Variable     | Becomes                   |
| ------------ | ------------------------- |
| `{membro}`   | Mentions the creator      |
| `{nome}`     | The creator's name        |
| `{servidor}` | The Discord server's name |
| `{nivel}`    | The creator's level       |
| `{canal}`    | The promotion channel     |
| `{motivo}`   | What the team wrote       |

### Embed

| Field             | What it does                                                                                              | Default       |
| ----------------- | --------------------------------------------------------------------------------------------------------- | ------------- |
| **Color**         | The panel, the confirmation, the team's notice and the log. The DM for new members uses the level's color | **Bot color** |
| **Server on top** | The server's name and icon above the panel and the DMs                                                    | On            |

## FAQ

**Posts aren't being counted.**
Check that the poster is an active creator and that the post was in the **Promotion channel**. If the page says the bot isn't receiving live events, posts from that period aren't counted; `/creator`, applications and decisions keep working.

**The member joined but didn't get the role.**
The bot's role must be above the **Creator role** and the level roles in **Server Settings → Roles** on Discord.

**The posts' text doesn't show.**
The bot doesn't have the **Message Content Intent**. Posts still count; turn the intent on in the Developer Portal to see text and links.

**Is this related to the store's affiliates?**
No. Creators is the Discord program. Commissions and creator codes in the store live in [Affiliates](https://fivedash.fivex.gg/docs/en/store/affiliates).

## Next steps

[Forms](https://fivedash.fivex.gg/docs/en/discord/forms)Details of the question editor used in the application.
[Bot](https://fivedash.fivex.gg/docs/en/discord/bot)Connect the bot, turn on the intents and set up roles.
[Commands](https://fivedash.fivex.gg/docs/en/discord/commands)Every command of the city bot.
[Plans and billing](https://fivedash.fivex.gg/docs/en/getting-started/plans-and-billing)What comes with Pro and Ultra.
