# Text Area Property

**URL:** <https://forums.realmacsoftware.com/t/text-area-property/49254>\
**Category:** Elements API\
**Created:** [July 28, 2025, 12:15am UTC](https://forums.realmacsoftware.com/t/text-area-property/49254 "2025-07-28T00:15:18Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![handshaper](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/handshaper/32/27373_2.png) [@handshaper](https://forums.realmacsoftware.com/u/handshaper)\
**Post date:** [July 28, 2025, 12:15am UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/1 "2025-07-28T00:15:18Z")

</div>

@dan How does one instruct a textArea property to display more than one line?

---

<div class="post-metadata">

**Author:** ![upssjw](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/upssjw/32/26063_2.png) [@upssjw](https://forums.realmacsoftware.com/u/upssjw)\
**Post date:** [July 28, 2025, 4:23am UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/2 "2025-07-28T04:23:53Z")

</div>

Also the subtitle works for Text but not for Text Area

 ![CleanShot 2025-07-28 at 05.21.53@2x](https://europe1.discourse-cdn.com/flex005/uploads/realmacsoftware1/original/3X/f/c/fca24da9376743c5c2eb8046b8e860e4625abaf3.png)

---

<div class="post-metadata">

**Author:** ![tpbradley](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/tpbradley/32/25503_2.png) [@tpbradley](https://forums.realmacsoftware.com/u/tpbradley)\
**Post date:** [July 28, 2025, 8:53am UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/3 "2025-07-28T08:53:54Z")

</div>

> [@handshaper](#):
>
> How does one instruct a textArea property to display more than one line?

You can use the `size` property, like this

```auto
{
    "title": "TextArea",
    "id": "myTextArea",
    "textArea": {
        "size": 20,
        "default": "Hello World",
        "subtitle": "a multi-line text input"
    }
}

```

> [@upssjw](#):
>
> Also the subtitle works for Text but not for Text Area

Text area doesn’t support subtitle yet, but we may add this in the future. I’ll add a ticket for it.

---

<div class="post-metadata">

**Author:** ![handshaper](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/handshaper/32/27373_2.png) [@handshaper](https://forums.realmacsoftware.com/u/handshaper)\
**Post date:** [July 28, 2025, 4:47pm UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/4 "2025-07-28T16:47:12Z")

</div>

Is the value the number of lines that the text area will display?

---

<div class="post-metadata">

**Author:** ![upssjw](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/upssjw/32/26063_2.png) [@upssjw](https://forums.realmacsoftware.com/u/upssjw)\
**Post date:** [July 28, 2025, 4:57pm UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/5 "2025-07-28T16:57:05Z")

</div>

see the manual has been updated great, but still showing subtitle

as per @handshaper what does this do

 ![CleanShot 2025-07-28 at 17.55.44@2x](https://europe1.discourse-cdn.com/flex005/uploads/realmacsoftware1/original/3X/b/8/b85bdf76dff125435604559ee74b63bebf760bb4.png)

---

<div class="post-metadata">

**Author:** ![tpbradley](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/tpbradley/32/25503_2.png) [@tpbradley](https://forums.realmacsoftware.com/u/tpbradley)\
**Post date:** [July 28, 2025, 5:54pm UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/6 "2025-07-28T17:54:49Z")

</div>

> [@upssjw](#):
>
> still showing subtitle

Oh! So it is! I need to whip that out of there… for now.

---

<div class="post-metadata">

**Author:** ![handshaper](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/handshaper/32/27373_2.png) [@handshaper](https://forums.realmacsoftware.com/u/handshaper)\
**Post date:** [July 28, 2025, 6:27pm UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/7 "2025-07-28T18:27:32Z")

</div>

@tpbradley I noticed that when I set this, the actual area displayed in the inspector only goes to 4 lines; anything greater causes a scrollbar to become active in the text area. Is this the correct behavior?

---

<div class="post-metadata">

**Author:** ![tpbradley](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/tpbradley/32/25503_2.png) [@tpbradley](https://forums.realmacsoftware.com/u/tpbradley)\
**Post date:** [July 28, 2025, 7:39pm UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/8 "2025-07-28T19:39:49Z")

</div>

That’s strange, do you have a simple example that reproduces it? This is how mine looks.

 ![CleanShot 2025-07-28 at 20.37.53@2x](https://europe1.discourse-cdn.com/flex005/uploads/realmacsoftware1/original/3X/e/b/eb669fb3d47ac5817c4a7c8c83b51bfc51998b3f.jpeg)

---

<div class="post-metadata">

**Author:** ![upssjw](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/upssjw/32/26063_2.png) [@upssjw](https://forums.realmacsoftware.com/u/upssjw)\
**Post date:** [July 28, 2025, 7:57pm UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/9 "2025-07-28T19:57:33Z")

</div>

adding these lines displays text inline?

 ![CleanShot 2025-07-28 at 20.56.02@2x](https://europe1.discourse-cdn.com/flex005/uploads/realmacsoftware1/original/3X/e/6/e6eddb7e70126f6b112fc2a86e1fefac072b5523.png)

---

<div class="post-metadata">

**Author:** ![handshaper](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/handshaper/32/27373_2.png) [@handshaper](https://forums.realmacsoftware.com/u/handshaper)\
**Post date:** [July 28, 2025, 8:06pm UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/10 "2025-07-28T20:06:44Z")

</div>

@tpbradley This is what mine looks like, I have the number of lines set to 10 in this case.

I’ll see if I can create a simpler test project to show off what I’m seeing.

 ![CleanShot 2025-07-28 at 10.05.12@2x](https://europe1.discourse-cdn.com/flex005/uploads/realmacsoftware1/original/3X/3/0/30e31ca8d11900d9961cbd1dd0e2e805185fd305.png)

---

<div class="post-metadata">

**Author:** ![tpbradley](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/tpbradley/32/25503_2.png) [@tpbradley](https://forums.realmacsoftware.com/u/tpbradley)\
**Post date:** [July 28, 2025, 8:33pm UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/11 "2025-07-28T20:33:24Z")

</div>

> [@upssjw](#):
>
> adding these lines displays text inline?

Yes, you’ll need to pre-process new lines in a hooks file, replacing them with something like a `<br>` tag. Something like this should do it.

```auto
const transformHook = (rw) => {    
    const { myTextArea } = rw.props;

    const processedText = myTextArea.replace(/\n/g, "<br>");
    
    rw.setProps({
        myTextArea : processedText
    });
}

exports.transformHook = transformHook;

```

---

<div class="post-metadata">

**Author:** ![upssjw](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/upssjw/32/26063_2.png) [@upssjw](https://forums.realmacsoftware.com/u/upssjw)\
**Post date:** [July 28, 2025, 8:38pm UTC](https://forums.realmacsoftware.com/t/text-area-property/49254/12 "2025-07-28T20:38:34Z")

</div>

> [@tpbradley](#):
>
> ```auto
> const transformHook = (rw) => {    
> const { myTextArea } = rw.props;
> 
> const processedText = myTextArea.replace(/\n/g, "<br>");
>     
> rw.setProps({
> myTextArea : processedText
> });
> }
> 
> exports.transformHook = transformHook;
> 
> ```

thanks that works