> For the complete documentation index, see [llms.txt](https://docs.samita.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.samita.io/bulk-price-editor-sami/getting-started.md).

# Getting started

Install Sami Bulk Price Editor and run your first bulk edit task.

## Install the app

{% stepper %}
{% step %}

### Add the app from the Shopify App Store

Open <https://apps.shopify.com/bulk-price-editor-sami> and click **Install**. Log in to your store if Shopify asks you to.
{% endstep %}

{% step %}

### Approve the permissions

The app asks for access to products, inventory and publications (sales channels). These are needed to read your catalog, write the changes you request and publish or unpublish products.
{% endstep %}

{% step %}

### Choose a plan

On first launch the app shows the **Choose your plan** page. Pick **Continue as Free** to start on the Free plan, or start a paid plan. Paid plans include a free trial. See [Plans and pricing](/bulk-price-editor-sami/settings-and-plans/plans-and-pricing.md).
{% endstep %}

{% step %}

### Open the app

In your Shopify admin go to **Apps › Bulk Price Editor Sami**. The app menu has six entries: **Dashboard**, **New bulk edit**, **Tasks**, **Settings**, **Pricing** and **Contact us**.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Before your first real run, check **Settings › Timezone**. Scheduled start and revert times use this timezone. By default it follows your Shopify store timezone. See [Set your timezone](/bulk-price-editor-sami/settings-and-plans/timezone.md).
{% endhint %}

## Run your first bulk edit

The example below lowers the price of every product by 10% right now and puts the old price in **Compare at price** so the storefront shows a strike-through discount.

{% stepper %}
{% step %}

### Click New bulk edit

From the dashboard click **New bulk edit**, or use **New bulk edit** in the app menu. The **Choose a Field to Edit** page opens.
{% endstep %}

{% step %}

### Select the Price field

Open the **Variant fields** group (or **Most popular**) and click **Select** on **Price**.

<figure><img src="https://1559832597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw4HtMDNMyRJ8FelzhTov%2Fuploads%2Fgit-blob-9fb9c4d2e08997be0498ae0e29808421f95c1b39%2Fchoose-field-variant-fields.png?alt=media" alt="Choose a Field to Edit page with the Variant fields group open"><figcaption><p>Choose a Field to Edit</p></figcaption></figure>
{% endstep %}

{% step %}

### Configure the edit

* **Task name**: type a name you will recognize later, for example `Summer Sale -10%`.
* **Edit method**: keep **Decrease by percentage** and enter `10` in **Value**.
* **Rounding**: keep **Round to nearest .01**.
* Under **Compare at price** choose **Set the compare-at price** and keep **Set the compare-at price to the current price**.

<figure><img src="https://1559832597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw4HtMDNMyRJ8FelzhTov%2Fuploads%2Fgit-blob-11e701e45b59dca2ec3fd580dde0bd260017e78f%2Ffield-price.png?alt=media" alt="Field to edit card for Price with Decrease by percentage, value, rounding and the compare-at price option"><figcaption><p>Field to edit</p></figcaption></figure>
{% endstep %}

{% step %}

### Choose the products

Under **Apply to products** keep **All products**. The **Preview** on the right updates and shows the original and the new price for each variant.

<figure><img src="https://1559832597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw4HtMDNMyRJ8FelzhTov%2Fuploads%2Fgit-blob-b306c85931cbd5f1bf476a1dbed3ea0373e8edc0%2Fpreview-price.png?alt=media" alt="Preview table with Original price, Update price, Original compare at price and Update compare at price columns"><figcaption><p>Preview</p></figcaption></figure>
{% endstep %}

{% step %}

### Choose when to run

Under **Start time** keep **Now**. If you want the prices to go back automatically, tick **Schedule the revert** and pick the date and time.
{% endstep %}

{% step %}

### Save and confirm

Click **Save** in the top bar. Because the task starts now, a **Task confirmation** dialog summarises the change. Read it, then click **Save**. The task starts and the app opens the task details page.

<figure><img src="https://1559832597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw4HtMDNMyRJ8FelzhTov%2Fuploads%2Fgit-blob-9b3bf69461caf4b533578cc4b50998938e179c08%2Ftask-confirmation.png?alt=media" alt="Task confirmation dialog summarising the edit, the products it applies to and important notes"><figcaption><p>Task confirmation</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## What happens next

* The task details page refreshes while the task runs and shows **Products changed** as a progress bar.
* When the status becomes **Completed**, the **Product changes** table lists every product with its original and updated values.
* The change appears in your Shopify admin right away. Your storefront may take a few minutes to show it because of caching.
* You can undo the whole task with **Revert now**. See [Revert changes](/bulk-price-editor-sami/manage-tasks/revert-changes.md).

{% hint style="warning" %}
Not sure about a setting? Start the task with **Manual** instead of **Now**. The task is saved without running, you can edit it as often as you like, and you start it later with **Apply change now**. See [Edit a scheduled or manual task](/bulk-price-editor-sami/manage-tasks/edit-a-task.md).
{% endhint %}

## Try it on a demo product first

The task form shows a banner **Try a demo run first**. Click **Create product** and the app creates a demo product in your store and switches the task to **Specific products** with only that product selected. Run the task on the demo product, check the result, then change the selection to your real products.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.samita.io/bulk-price-editor-sami/getting-started.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.