# How to add effects

You can add effects to your texts in the following ways:

### Set effects to specific parts of the text <a href="#set-effects-to-specific-parts-of-the-text" id="set-effects-to-specific-parts-of-the-text"></a>

You can add effects to specific parts of your text by using **rich text tags.**

The effects tag will look like this:

* **Persistent**: `<tagID>` to open, `</tagID>` to close
* **Appearances**: `{tagID}` to open, `{/tagID}` to close
* **Disappearances**: `{#tagID}` to open, `{/#tagID}` to close\
  \&#xNAN;*(basically an appearance tag with a `#` before it, to simply remind you that disappearances are appearances in reverse)*.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FsNWP4FirbP7rwT5nMSgN%2FTag_Example_TAnim3.0.mp4?alt=media&token=cbc0e61e-038a-4b3e-9116-432cf6ca6a94>" %}

#### Extra notes about Rich Text formatting <a href="#extra-notes-about-rich-text-formatting" id="extra-notes-about-rich-text-formatting"></a>

By using TextAnimator for Unity:

* You can stack multiple effects together (e.g. “`<shake><size>`”).\
  (also have a look at [styles](https://docs.febucci.com/text-animator-unity/customization/styles "mention"))
* You can close **all** currently opened effects with a single ‘`/`’ character, like:
  * ”`</>`” for Persistent Effects
  * ”`{/}`” for Appearance Effects
  * ”`{/#}`” for Disappearance Effects.
* There is no need to close tags if you’re at the end of the text, since Text Animator starts applying effect from the moment you open a tag. (e.g. "`<shake>hello`" will result in hello already animating).

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FBg3rDgfMUSYXWod3YRWa%2FStackEffects.mp4?alt=media&token=cb667514-8b82-40d2-b4ff-6450e652aa52>" %}

{% hint style="info" %}
To display raw text, use the `<noparse>` tag to prevent Text Animator from parsing other tags.
{% endhint %}

***

### Set default effects to the entire text <a href="#set-default-effects-to-the-entire-text" id="set-default-effects-to-the-entire-text"></a>

You can decide which effect(s) will be applied to all letters by default, **without having to write effects tags inside your texts** thanks to [animator-settings](https://docs.febucci.com/text-animator-unity/effects/how-to-add-effects/animator-settings "mention").

{% tabs %}
{% tab title="UI Toolkit" %}
AnimatedLabel's settings are handled via different scriptable objects (in this case, the one highlighted in the image below). Read more here on [how to create one](https://docs.febucci.com/text-animator-unity/effects/how-to-add-effects/animator-settings).

{% hint style="success" %}
If you didn't set one, the one in the [global-settings](https://docs.febucci.com/text-animator-unity/customization/global-settings "mention") will be used!
{% endhint %}

<figure><img src="https://3857371675-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FagcdeSBrmD3NCQLoVswt%2FScreenshot%202025-11-15%20alle%2018.33.00.png?alt=media&#x26;token=6d57fa83-5f8f-475d-940f-280151ce67d5" alt="" width="314"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Text Mesh Pro" %}
For Text Mesh Pro, settings can be "local" (bound to the component), or "shared" (between other Text Animator instances).

* To modify **local** settings, simply head over to the "TextAnimator - Text Mesh Pro" component inspector and tweak their values.
* To modify **shared** settings, assign the relative ScriptableObject instance. [Read more here](https://docs.febucci.com/text-animator-unity/effects/how-to-add-effects/animator-settings).
  {% endtab %}
  {% endtabs %}

Inside the settings:&#x20;

1. Visit the “Default Tags” section
2. Expand the effect’s category you want to edit
3. Add any effect tag you want to include, for example:

<figure><img src="https://3857371675-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FMGbfDEQeK1CRnktW6aue%2FScreenshot%202025-11-15%20alle%2018.48.23.png?alt=media&#x26;token=2a7db44e-c31a-48ae-a317-871ca6006070" alt="" width="362"><figcaption></figcaption></figure>

{% hint style="info" %}
&#x20;If you don’t want any effect applied by default, simply set the effects’ count to zero.
{% endhint %}

{% hint style="success" %}
You can also change the "**Default Tags Mode**" to "**Constant**" if you want effects to be applied all the time, on top of everything.
{% endhint %}

{% hint style="success" %}
You can add Modifiers to each array element, like "shake a=5", read more here: [modifiers](https://docs.febucci.com/text-animator-unity/effects/how-to-edit-effects/modifiers "mention")
{% endhint %}

<details>

<summary>Example: Fallbacks</summary>

Let's say that we have one default effect ("size"), but we want to apply a specific part of the text with the "fade" effect.\
We can achieve that result by writing: "default default \`{fade}\` fade fade fade \`{/fade}\` default default"

![](https://content.gitbook.com/content/XuXUTa2X5PYuYL6yRvl1/blobs/fkwPOWUP3UA38XjdRWRQ/text-animator-override-appearances-example-ezgif.com-video-to-gif-converter.gif)

As you can see, the letters that are outside the "fade" tags will have the default effect(s) applied, while the part inside "{fade}" and "{/fade}" will only have "fade".

</details>
