Skip to main content

Tags

Overview​

Tags are custom commands that allow for users to create custom responses to a given tag name. Simply add a tag, invoke it with either command notation or inline notation, and ClemBot will respond with that tag's content in a given channel.

ClemBot's tags support the idea of ownership. If a user creates a tag, that tag is owned by them until they either leave the server or transfer the tag to someone else. By owning the tag they are allowed to either edit or delete the tag. When a user leaves a server, all of their owned tags become unclaimed and can be claimed by anyone else in the server.

ClemBot also tracks what tags are popular and allows for you to access that information. You can view the total number of uses of a tag as well as its owner and creation date with the tag info command or on the dashboard.

caution

If you leave the server, all owned tags will become unowned and can be claimed by other users in that server.

Inline Notation​

Tags in ClemBot can be invoked in the middle of a message by prefixing the tag name with a $. This allows for more organic tag usage in the middle of a conversation.

note

By default, the tag prefix for any server is $. However, this can be changed. See Prefix on how to view, change, and reset the prefix.

Example​

Discord Message
Hello there, new person. Have you checked out $funstufftodohere yet?

Dashboard​

A guild's tags can be viewed from the tag tab on the dashboard. You can filter tags, create new tags, or just view what tags have been created.

Commands​

Tag​

If invoked with no tag name, it will show all tags in the server. If a name is provided, it will attempt to invoke that tag.

Aliases​

  • tags

Format​

List all tags in the server
!tag
Invoke a given tag
!tag <tagname>

Example​

!tag
!tag mytagname

Add​

Create a tag in the server.

Aliases​

  • create
  • make

Required Claims​

  • tag_add

Format​

!tag add <TagName> <TagContent>

Example​

!tag add MyTag ClemBot is an awesome bot!

Remove​

Delete a tag from the server.

Aliases​

  • delete
  • remove

Required Claims​

  • tag_delete
note

You do not need the tag_delete claim to delete a tag that you own.

Format​

!tag delete <TagName>

Example​

!tag delete MyTag

Edit​

Edit a tag in the server.

Format​

!tag edit <TagName> <NewTagContent>

Example​

!tag edit MyTag ClemBot is a super duper cool bot!

Info​

Gets info about a given tag in a server.

Aliases​

  • about

Format​

!tag info <TagName>

Example​

!tag info MyTag

Searches for a tag in the guild/server using the query provided.

Aliases​

  • find

Format​

!tag search <query>

Example​

!tag find my_tag
!tag search thingsyoucandohere

Owned​

Lists all tags owned by you or a given user, if provided.

Aliases​

  • claimed

Format​

!tag owned [user]

Example​

!tag owned
!tag claimed @myfriend

Claim​

Claims a given unowned tag.

Format​

!tag claim <TagName>

Example​

!tag claim SomeUnownedTag

Transfer​

Transfers a given owned tag to a new owner in the same server.

Format​

!tag transfer <TagName> <TagRecipient>

Example​

!tag transfer MyTag @MyBestFriend
note

If a user has the tag_transfer claim, they can transfer tags they do not own.

Unclaimed​

Lists all unclaimed tags in the server.

Example​

!tag unclaimed

Prefix​

A group of commands used to preview, set, or reset the prefix for tags.

Format​

!tag prefix [<prefix> | reset]

Tag Prefix​

Gets the current tag prefix.

Example​
Display the current tag prefix
!tag prefix
Set a custom tag prefix
!tag prefix #
note

Custom tag prefixes can have more than one character.

caution

Custom tag prefixes cannot contain the character `.

Required Claims​
  • custom_tag_prefix_set
note

The command !tag prefix does not require the claim, but !tag prefix <new prefix> does.

Tag Reset​

Resets the tag prefix.

Aliases​
  • revert
Example​
Reset the tag prefix
!tag prefix reset
Required Claims​
  • custom_tag_prefix_set
note

When running the command !tag prefix reset, the tag prefix will be reverted to $.