Can I push more than one item at once?

Yes, provide multiple items in the push box using the same separator as your main list, and they're all added at the front, in the order given.

Does this change the order of the existing items?

No, the existing items keep their relative order; they're just shifted after the newly pushed items.

How is this different from List Item Appender?

List Item Pusher adds items to the front of the list; List Item Appender adds them to the end. They're mirror-image operations.

What if I want to remove items from the front instead?

This tool only adds items. Use List Truncator or List Item Popper if you need to remove items instead.

List Item Pusher - Add Items to the Front of a List

Overview

Introduction

Sometimes new items belong at the start of a list rather than the end, a new priority task, a header row, or a value that logically comes first.

List Item Pusher adds one or more new items to the front of your list in a single step, leaving the rest of the list intact and simply shifted after them.

What Is List Item Pusher?

This is a list-editing tool modeled on the classic "push" (prepend) operation, extended to support pushing multiple items at once rather than just one.

Both the base list and the items to push use the same configurable separator, so the operation stays consistent regardless of your list's format.

How List Item Pusher Works

The base list and the items-to-push text are each split into arrays using the chosen separator.

The push items array is concatenated in front of the base items array, then the combined array is rejoined into the output text.

When To Use List Item Pusher

Use this when you need to add new entries that should appear before the existing content, like inserting a new highest-priority item at the top of a list.

It pairs naturally with List Item Appender (add to the end instead) and List Item Popper (remove from the end).

Often used alongside List Item Appender, List Item Popper and List Duplicator.

Features

Advantages

Preserves the exact order and content of the original list, just shifted after the new items.
Supports pushing multiple new items at once, not just one.
Works with any separator style consistently across both inputs.

Limitations

Only adds to the front of the list; use List Item Appender to add to the end instead.
Doesn't deduplicate, if a pushed item already exists in the list, it will appear twice.

Examples

Pushing two items to the front

Input

list: c, d — items to push: a, b

Output

a, b, c, d

Both new items are placed before the existing two, in the order given.

Pushing a single item

Input

list: b, c — items to push: a

Output

a, b, c

One new item is added to the front of the list.

Best Practices & Notes

Best Practices

Keep the same separator for both the base list and the push items to avoid mismatched parsing.
Use this together with List Item Appender if you need to add items at both ends of a list.

Developer Notes

Both inputs are parsed with the shared `splitListItems()` helper, combined with `Array.prototype.concat()` (push array placed first), and rejoined with `joinListItems()`.

List Item Pusher Use Cases

Inserting a new highest-priority task at the top of a to-do list
Adding a header or label item to the start of a data list
Prepending newly discovered entries to an ongoing dataset

Common Mistakes

Using a different separator for the push box than the main list, which can cause the new items to be parsed as one combined string.
Expecting duplicates to be automatically removed; they aren't, pushed items are added even if they already exist in the list.

Tips

Use List Item Appender instead if the new items should go at the end of the list rather than the start.
Follow up with List Statistics Generator to confirm the new total item count after pushing.

List Item Pusher