Tags
Unlock the full power of tags!
Do you have certain traits that you want to group together? With tags, you can easily create groups like species or trade to organize and automatically apply grouping rules. We recommend exploring tag options before setting complex rule sets.
Tags Overview
Tags work the best when you’d like to categorize and create rules within layers or create connections/rules across several different layers. Tags are a better choice for collections that have many asset options in a single component layer. They also provide an easy way to organize and view certain combinations of traits in your token batch preview, and these tag categories can be added into your metadata.
Tags tell Bueno what traits can go together. Tags on their own do not create an exclusive bond, and you must allocate all the traits in a component group to apply tag-specific rules.
While the tag rule function may seem counterintuitive, they actually give creators more flexibility with trait pairing options. This way, different tags in a tag category can share some traits, but also have their own unique traits assigned to them. Rarity is determined by the rarity settings of the traits.
Tags can be a bit confusing at first, so we encourage you to keep reading to learn more!
Applying Rules with Tags
To explain how Bueno applies rules with tags, let’s start out with a very simple example. Let’s say that we have three component groups for our collection besides our base bodies - Clothes, Eyes and Headgear.
![](https://docs.bueno.art/~gitbook/image?url=https%3A%2F%2F3197803409-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fo9IBs7DeWK0IjMWTqEXb%252Fuploads%252FZ3JgL96Bwt29p26B1uIG%252Fnew-tags-attributes.png%3Falt%3Dmedia%26token%3D1e4930b7-e1f7-444b-a97d-d2fc64fe983e&width=768&dpr=4&quality=100&sign=e3524f5&sv=1)
Within each category, we have several different token types with distinct styles. Let’s say we have designs for aliens, robots and monsters. The body colors can match any design type.
![](https://docs.bueno.art/~gitbook/image?url=https%3A%2F%2F3197803409-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fo9IBs7DeWK0IjMWTqEXb%252Fuploads%252FV0wAsIizbDwkPGZZpUYT%252FGente.png%3Falt%3Dmedia%26token%3D2b15e6cb-1e64-48d4-b917-c2bca68d51c4&width=768&dpr=4&quality=100&sign=b57a8514&sv=1)
Let’s go to tags. We create a tag group called “species,” and add a tag for each token type.
![](https://docs.bueno.art/~gitbook/image?url=https%3A%2F%2F3197803409-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fo9IBs7DeWK0IjMWTqEXb%252Fuploads%252FEPK0YoTOLmEGNMVM2N1g%252FCleanShot%25202022-08-03%2520at%252016.04.58%25402x.png%3Falt%3Dmedia%26token%3D8ea09f84-f736-481c-bf2a-8a3d12a2de0a&width=768&dpr=4&quality=100&sign=3481be2b&sv=1)
Let's start with alien. Under alien, we can select the alien clothing, three eyes and fishbowl helmet.
![](https://docs.bueno.art/~gitbook/image?url=https%3A%2F%2F3197803409-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fo9IBs7DeWK0IjMWTqEXb%252Fuploads%252FMQUn4rLSxCCcevuilvxe%252FCleanShot%25202022-08-03%2520at%252016.03.16%25402x.png%3Falt%3Dmedia%26token%3D12fa82ea-24ce-4095-913a-e811892e4382&width=768&dpr=4&quality=100&sign=b9889d5b&sv=1)
Awesome, the traits are now connected by a tag! Let’s go to preview…
…wait just a second! While you can now filter and find “aliens” in preview, you notice that your alien clothes, eyes and helmet are still showing up with monster and robot parts! What’s up with that, Bueno!?
![](https://docs.bueno.art/~gitbook/image?url=https%3A%2F%2F3197803409-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fo9IBs7DeWK0IjMWTqEXb%252Fuploads%252FR6soRZNmhavYgL13PiOF%252Fgood-bad.png%3Falt%3Dmedia%26token%3Dcca30c61-5c98-40b0-a746-431d3b273c4d&width=768&dpr=4&quality=100&sign=1b301392&sv=1)
Well, this is because tags tell Bueno what traits can go together, but not what traits can’t go together. The tags are incomplete. Let’s head back.
Now, we will create tags for the monsters and the robots. Under the monster tag, we will select the monster clothes, cyclops eye and horn head. Under the robot tag, we will select the robot clothes, visor eyes and mohawk head. We’re also going to tag a fourth trait - mouth. Our aliens and robots will have a standard smile, but our monsters will have fangs.
![](https://docs.bueno.art/~gitbook/image?url=https%3A%2F%2F3197803409-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fo9IBs7DeWK0IjMWTqEXb%252Fuploads%252FfpdwYe21VIFv6fSdXbLS%252FCleanShot%25202022-08-03%2520at%252016.09.19%25402x.png%3Falt%3Dmedia%26token%3D99934366-a77d-46e8-a5d1-370d3393b25d&width=768&dpr=4&quality=100&sign=6571ec39&sv=1)
Back to preview - your tag rules have now applied! How? This is because you need to allocate all options in a component group if you’ve selected to tag something from it. Simply put, you need a counterpoint to create “cannots.”
If two traits across two different attribute groups (alien clothes, three eyes) are introduced to a single tag and the rest (monster clothes, robot clothes, cyclops eye, visor eye) aren’t selected in another tag, Bueno will assume that those tagged traits can still go with any other trait in the attribute groups. Basically, tags on their own do not create an exclusive bond.
You must allocate all the traits in an attribute group to apply tag-specific rules. With the traits in the attribute groups all allocated to at least one tag, Bueno knows that all the traits have specific instances where they are allowed to appear, and will now follow those rules.
Tagging Tips
Tip #1: Create a counter tag.
Whenever you start to create a tag, try to categorize them with at least one countering tag. If you have female-specific traits, also tag male-specific traits (even if they overlap); If only some tokens can hold a magic item based on their clothes - also tell Bueno what clothes the non-magic item(s) can go with.
Tip #2: Find your anchor trait.
It’s also helpful to think of an anchor trait. What is the main trait that connects some and excludes others? For the magic item example above, the anchor trait could be a magician’s hat. If the token has a magician's hat, it can hold magic items in addition to the non-magic items. If that hat is not present, it can only hold non-magic items. The tag group could be called Magic Type with the tags Magician and Non-magician.
Last updated