> For the complete documentation index, see [llms.txt](https://smash.gitbook.io/smash-ai-products-description-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smash.gitbook.io/smash-ai-products-description-docs/basics/bulk-management.md).

# Bulk Management

### Bulk Management Overview

The **Bulk Page** is where you manage all your bulk generations. From the **Bulk Listing Page**, you can get an overview of all bulk operations, including their progress and status. Clicking on any bulk entry takes you to the **Bulk Detail Page**, where you can see detailed information and manage individual bulk processes.

### 1. Bulk Listing Page

<figure><img src="/files/B1qPbh1jIcpOkTFew9S1" alt=""><figcaption></figcaption></figure>

The **Bulk Listing Page** provides an overview of all bulk generations with key summary columns:

* **Bulk ID:** Unique identifier for each bulk process.
* **Date:** Timestamp when the bulk process was created.
* **Title:** Indicates whether product titles were generated.
* **Description:** Indicates whether product descriptions were generated.
* **SEO:** Indicates whether metadata (SEO information) was generated.
* **Completed:** Displays the number of completed product descriptions compared to the total number of products in the bulk (format: `completed/total`).
* **Synced to Shopify:** Displays how many product descriptions have been synced to your Shopify store (format: `completed/total`).
* **Type:** The type of bulk generation, which can be one of the following:
  * **Collection**: Generates descriptions for all products in a specific collection.
  * **All Products**: Generates descriptions for all store products.
  * **Manual**: Manually selected products for bulk generation.
  * **Auto**: Automatically generated bulk based on predefined rules.

#### Sorting and Filtering

You can sort the bulk list by **Bulk ID** or **Created Date**.

Additionally, you can switch tabs to filter bulk processes based on their status:

* **Completed:** Displays only bulk processes where 100% of product descriptions have been generated.
* **Incomplete:** Displays bulk processes that are not yet fully generated.
* **Synced:** Displays bulk processes where 100% of product descriptions have been synced to Shopify.
* **Unsynced:** Displays bulk processes that have not been fully synced to Shopify.

These filters help you quickly find and manage your bulk processes efficiently.

{% hint style="info" %}
📌 **Tip:** Automated bulk processes depend on Shopify webhooks, which means they do not have a predefined total count. As a result, their progress will always display as `(completed/completed)`.
{% endhint %}

### 2. Bulk Detail Page

<figure><img src="/files/BOJOajyT9Gra07oGXoQJ" alt=""><figcaption></figcaption></figure>

Clicking on a bulk entry from the **Bulk Listing Page** takes you to the **Bulk Detail Page**. Here, you can:

* View a detailed breakdown of the bulk process.
* Monitor progress for each product within the bulk.
* Manually regenerate or sync descriptions if needed.

This page provides granular control over each bulk operation, allowing you to fine-tune and manage your product descriptions more effectively.

{% hint style="info" %}
Only **successfully generated** product descriptions will consume credits. **Failed generations will not be charged.**
{% endhint %}

#### Overview

At the top of the page, a **status bar** displays key information:

* **Bulk Type** (Collection, All Products, Manual, or Auto)
* **Processing Status** (whether generation is still in progress or completed)

#### Product List

The **Bulk Detail Page** displays all products in the bulk in a table format. Two key columns:

1. **Status** – Indicates the status of the content generation process for each product:
   * `GENERATING` – Content is being generated.
   * `FAILED` – Generation failed.
   * `COMPLETED` – Content was successfully generated.
2. **Shopify Status** – Indicates the synchronization status with Shopify:
   * `PENDING` – Not yet synced.
   * `SYNCING` – Currently syncing.
   * `SYNCED` – Successfully synced to Shopify.
   * `FAILED` – Syncing failed.

#### Product Content Editing

Clicking on a product row opens a **modal** containing the AI-generated content, including:

* **Title**
* **Description**
* **SEO Metadata**

In the modal, you can:

* Edit any fields and click **Save** to update the database.
* Click **Sync to Shopify** to update the Shopify product.
* Click **Re-generate** to create a new AI-generated version.
* Click **View on Product Page** to open the Shopify product page.
* **Discard changes** if you do not wish to save updates.

{% hint style="info" %}
**Handling Failed Generations**

To manually review or regenerate failed products:

1. Switch to the **Incomplete** tab.
2. Select the checkbox in the table header to enable the bulk action **Re-generate**.
   {% endhint %}

### Action Buttons

At the top of the page, a set of action buttons helps you manage the bulk process:

* **Reload** – Refreshes the page and fetches the latest bulk data from the server.
* **Retries**:
  * **Retry Failed Generations** – Attempts to regenerate content for all products that previously failed.
* **Actions**:
  * **Pause / Continue Sync All to Shopify** – Rarely needed, but allows you to pause or resume syncing all products to Shopify.
* **Collection-Only Actions** (Visible only for "Collection" or "All Products" bulks):
  * Pause or continue the content generation process.
* **Sync All to Shopify** – Once the bulk generation process is complete, click this button to sync all generated product descriptions to Shopify.

{% hint style="warning" %}
**Caution:** If a product has been deleted from Shopify, its AI-generated content cannot be synced.
{% endhint %}