# Adding multiple items to substitutions

**URL:** <https://forum.literatureandlatte.com/t/adding-multiple-items-to-substitutions/154599>\
**Category:** Scrivener\
**Tags:** support\
**Created:** [September 4, 2026, 4:31pm UTC](https://forum.literatureandlatte.com/t/adding-multiple-items-to-substitutions/154599 "2026-09-04T16:31:11Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![franklekens](https://forum.literatureandlatte.com/letter_avatar_proxy/v4/letter/f/6a8cbe/32.png) [@franklekens](https://forum.literatureandlatte.com/u/franklekens)\
**Post date:** [September 4, 2026, 4:31pm UTC](https://forum.literatureandlatte.com/t/adding-multiple-items-to-substitutions/154599/1 "2026-09-04T16:31:12Z")

</div>

I’m a potential new user and I’m wondering about the substitutions feature, something I use a lot in other word processors. I notice the interface only allows you to add one item at a time, in rather mouse oriented menus. Is there a way to import a list of substitution items from another programme (if it’s formatted in a specific way, e.g. comma or tab separated items or something like that)?  
Or does Scrivener store all substitutions in a plain text file that could be edited with Notepad, so one could import them that way?  
And if so, is there a maximum number of items the list could contain?

If not, I guess that would be my feature request if I were user – but since I’m not fully that yet, I’m not going to put it in there just yet.

---

<div class="post-metadata">

**Author:** ![November\_Sierra](https://forum.literatureandlatte.com/user_avatar/forum.literatureandlatte.com/november_sierra/32/41086_2.png) [@November\_Sierra](https://forum.literatureandlatte.com/u/November_Sierra)\
**Post date:** [September 4, 2026, 5:42pm UTC](https://forum.literatureandlatte.com/t/adding-multiple-items-to-substitutions/154599/2 "2026-09-04T17:42:39Z")

</div>

> [@franklekens](#):
>
> Is there a way to import a list of substitution items from another programme

Once you’ve entered them, it’s easy to select all (or just some) and just drag them over to another project (the lists are project-specific). The manual talks about this under “20.2.2 Custom Auto-completion”, page 514. (Mac version)

> [@franklekens](#):
>
> Or does Scrivener store all substitutions in a plain text file that could be edited with Notepad, so one could import them that way?

Yes, but…

I’ll preface it with DON’T DO IT. I’M NOT RESPONSIBLE IF YOU BREAK ANYTHING! That being said:

The list is stored in the `... .scrivx` file, located inside each project’s package / folder. It’s basically XML. There’s a section

```xml
<AutoCompleteList>
        <Completion Scope="-1">Jane Doe</Completion>
        <Completion Scope="-1">John Doe</Completion>
        <Completion Scope="-1">Whatever</Completion>
</AutoCompleteList>

```

and the possible “scope” values are

```nohighlight
-1 General Text
-2 All (Text & Scripts)
 0 Script (Scene Heading)
 1 Script (Scene Action)
 2 Script (Character & Dialogue)
 3 Script (Dialogue (Cont.))

```

So a very careful person could in theory, if this Scrivener project isn’t open, easily… you know. In and out. But that’s no official advice. Don’t do it. I’m just a fellow user.

---

<div class="post-metadata">

**Author:** ![GoalieDad](https://forum.literatureandlatte.com/user_avatar/forum.literatureandlatte.com/goaliedad/32/28584_2.png) [@GoalieDad](https://forum.literatureandlatte.com/u/GoalieDad)\
**Post date:** [September 4, 2026, 9:44pm UTC](https://forum.literatureandlatte.com/t/adding-multiple-items-to-substitutions/154599/3 "2026-09-04T21:44:13Z")

</div>

Make a copy of your project. File \> Save As and then experiment. If blows up no issue

---

<div class="post-metadata">

**Author:** ![November\_Sierra](https://forum.literatureandlatte.com/user_avatar/forum.literatureandlatte.com/november_sierra/32/41086_2.png) [@November\_Sierra](https://forum.literatureandlatte.com/u/November_Sierra)\
**Post date:** [September 5, 2026, 12:21am UTC](https://forum.literatureandlatte.com/t/adding-multiple-items-to-substitutions/154599/4 "2026-09-05T00:21:16Z")

</div>

One more thing I forgot to mention. Filling this list in the XML file by hand would be nonsensical, so assuming you have a text file containing all of your words, one per line, e.g.:

```nohighlight
item 1
item 2
item 3

```

Any decent text editor (I guess that excludes Notepad) should allow for RegEx search

```nohighlight
^(.*)$

```

and replace

```nohighlight
<Completion Scope="-1">$1</Completion>

```

and give you a nice list that you can sandwich between the `<AutoCompleteList>` `</AutoCompleteList>` tags mentioned above.
