Tagging
What is Tagging?
Utilize tag commands to efficiently organize your cards into custom groups. Assign names and emojis to these tags for quick and easy sorting of your various cards.
Kana offers various tag commands so that users can get the best out of tagging with minimal fuss.
All tags must be different and there should be no spaces in your tag name.
Add a Tag
Add a tag to a card using the [p]tag [t] command.
- Command:
[p]tag <tag name> [card/shade code]... - Alias: [
t] - Parameters:
<tag name>- The name of the tag to add.- (Optional)
[card/shade code]...- The card or shade unique identifiers. If not provided, defaults to the most recently acquired card.
Remove a Tag
Remove a tag from a card using the [p]untag [ut] command.
- Command:
[p]untag [card/shade code]... - Alias: [
ut] - Parameters:
- (Optional)
[card/shade code]...- The card or shade unique identifiers. If not provided, defaults to the most recently acquired card.
- (Optional)
Create a Tag
Create a new tag with a name and emoji using the [p]tagcreate [tc] command.
- Command:
[p]tagcreate <tag name> <emoji> - Alias: [
tc] - Parameters:
<tag name>- A unique tag name.<emoji>- A default unicode or custom emojis uploaded on Discord.
Delete a Tag
Delete a tag by name using the [p]tagdelete [td] command.
- Command:
[p]tagdelete <tag name> - Alias: [
td] - Parameters:
<tag name>- The name of the tag to delete.
Deleting a tag will remove it from all cards that currently have it assigned.
List Tags
List all your tags using the [p]taglist [tl] command.
- Command:
[p]taglist - Alias: [
tl] - Parameters: None
Only registered, unrestricted users with no privacy settings enabled for this command can have their tag list viewed.
Forgot your tag names? Use [p]taglist to get a list of them easily.
Rename a Tag
Rename an existing tag using the [p]tagrename command.
- Command:
[p]tagrename <current name> <new name> - Alias: [
trn] - Parameters:
<current name>- The existing tag name to rename.<new name>- The new name for the tag.
Change Tag Emoji
Change the emoji for a tag using the [p]tagemoji [te] command.
- Command:
[p]tagemoji <tag name> <new emoji> - Alias: [
te] - Parameters:
<tag name>- The name of the tag to change the emoji for.<new emoji>- The new emoji to assign to the tag.
Lock Cards from Sacrifice
A tag named lock is special: any card carrying it cannot be sacrificed, either individually with [p]sacrifice or through batch sacrifice. To sacrifice a locked card, remove the lock tag from it first.
Every account comes with a lock tag by default. It is protected and cannot be renamed or deleted. Just use [p]tag lock [card code]... to lock your cards.
Automatic Tagging
Set up rules to automatically tag cards or shades the moment they land in your collection. No more tagging everything by hand.
Create an Auto-Tag Rule
Use [p]autotagset to create or update a rule. Each rule matches newly acquired items against a set of filters and assigns them to a tag.
- Command:
[p]autotagset <card|shade> <tag> <priority> <filters> - Parameters:
<card|shade>- Whether this rule matches cards or shades.<tag>- An existing tag to assign matching items to.<priority>-1is highest priority; larger numbers are lower.-1is always lowest.<filters>- A filter expression (see below).
Examples:
| Rule | Command |
|---|---|
| Tag all tier 3 cards to "rare" | autotagset card rare 1 tier:3 |
| Tag low-print cards | autotagset card lowprint 2 print<=3 |
| Tag event cards to "event" | autotagset card event 3 event:true |
| Tag high-purity shades | autotagset shade radiant 1 purity>=8 |
| Tag glow shades | autotagset shade glowmod 2 modifier:glow |
Filter Syntax
Filters use the format <field><comparator><value>. Multiple filters are separated by spaces and must all match (AND logic).
Comparators: = != : (contains) !: (not contains) < <= > >= is is not
Card Filters
| Field | Aliases | Description | Example |
|---|---|---|---|
tier | ti | Card tier (1-3) | tier:3 |
print | p | Print number, or none | print<=3 |
wishlist | wl | Wishlist count | wishlist>=50 |
character | char, c, name, n | Character name (text match) | character:kana |
series | s | Series name (text match) | series:kana |
event | Is an event card | event:true | |
eventtag | et | Event tag name | eventtag:summer |
legacy | l | Is a legacy print | legacy:true |
rng | r | Is an RNG print | rng:true |
3d | Is a 3D card | 3d:true |
Shade Filters
| Field | Aliases | Description | Example |
|---|---|---|---|
tier | ti | Shade tier (0-5) | tier>=3 |
purity | p | Purity score (1-10) | purity>=8 |
glow | g | Glow score (1-10) | glow>=5 |
color | c, stops | Number of color stops | color>=3 |
name | n | Shade name (text match) | name:crimson |
type | ty | normal or cartoon | type:cartoon |
modifier | mod, m | glow | modifier:glow |
resonance | res, r | Resonance (0-100) | resonance>=80 |
Numeric fields support ranges with = like tier=1-3. OR lists use | like tier=1|3.
Remove an Auto-Tag Rule
Use [p]autotagremove to delete a rule.
- Command:
[p]autotagremove <card|shade> <tag> - Parameters:
<card|shade>- The item type of the rule.<tag>- The tag name the rule assigns to.
Toggle an Auto-Tag Rule
Temporarily enable or disable a rule without deleting it.
- Command:
[p]autotagtoggle <card|shade> <tag> <on|off>
List Your Auto-Tag Rules
View all your active auto-tag rules with [p]autotaglist.
- Command:
[p]autotaglist [page] - Parameters: None
Contributors are community members who assisted with documentation and are not directly affiliated with Kana.