> For the complete documentation index, see [llms.txt](https://birthdaybot.scottbucher.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://birthdaybot.scottbucher.dev/faq-1/birthday-system/zodiac-system.md).

# Zodiac System

## What are zodiac roles?

Zodiac roles are custom roles the bot will give to users periodically, as well as at certain specific events.&#x20;

The first way users can get their zodiac role is by simply running the `/claim_role option:Zodiac - Claim your missing zodiac role.` command at any time, and if they don't already have a zodiac role, the bot will give them one based on their birthday.

Secondly, as mentioned previously, the bot will automatically give out zodiac roles in the following scenarios:

* A user has their birthday celebrated
* A user sets their birthday in your server
* Randomly! The bot now slowly gives out missing zodiac roles a few every hour to help ensure everyone gets one!

Finally, a new placeholder, `{Zodiac Role}` can now be used and the Bot will replace it with the @ of the zodiac role for that message.

## What are Zodiac Emojis?

The `{Zodiac Emoji}` placeholder can be used in custom messages and, much like the zodiac sign placeholder, will be replaced with the zodiac emoji equivalent, such as ♍!&#x20;

However, the default emojis can be a little boring, so servers can  use the `/zodiac set_emoji` command to set their own custom zodiac emojis for the bot to use! Here is an example:

<figure><img src="/files/nvUrtuIRNj9H4APuGtxE" alt=""><figcaption></figcaption></figure>

## What is the Automatically Give Roles setting?

This setting decides if the bot should automatically give users their zodiac roles in the following scenarios:

* A user has their birthday celebrated
* A user sets their birthday in your server
* Randomly! The bot now slowly gives out missing zodiac roles a few every hour to help ensure everyone gets one!
