Server : Apache/2.4.52 (Ubuntu) System : Linux webserver 6.8.0-49-generic #49~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Wed Nov 6 17:42:15 UTC 2 x86_64 User : www-data ( 33) PHP Version : 8.1.2-1ubuntu2.21 Disable Function : NONE Directory :  /usr/share/doc/libjs-bootstrap4/utilities/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

---
layout: docs
title: Image replacement
description: Swap text for background images with the image replacement class.
group: utilities
---

{{< callout warning >}}
##### Warning

The `text-hide()` class and mixin has been deprecated as of v4.1. It will be removed entirely in v5.
{{< /callout >}}

Utilize the `.text-hide` class or mixin to help replace an element's text content with a background image.

```html
<h1 class="text-hide">Custom heading</h1>
```

```scss
// Usage as a mixin
.heading {
  @include text-hide;
}
```

Use the `.text-hide` class to maintain the accessibility and SEO benefits of heading tags, but want to utilize a `background-image` instead of text.

<div class="bd-example">
  <h1 class="text-hide" style="background-image: url('/docs/{{< param docs_version >}}/assets/brand/bootstrap-solid.svg'); width: 50px; height: 50px;">Bootstrap</h1>
</div>

```html
<h1 class="text-hide" style="background-image: url('...');">Bootstrap</h1>
```