> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit thousands of products at once with AI Rules Profiles

> Export products to a grid, apply a Rules Profile to AI-edit thousands of rows in one batch, then import and review every change before it touches your store.

Bulk Content Edit is the high-volume content engine inside Vortex Agents. It gives you a three-step workflow - Export to Grid, Generate with AI Request, Import File - that lets you apply consistent, brand-governed AI edits to every product description, collection page, or content block on your store in a single operation, without touching a spreadsheet cell by hand. Every batch is held for your review before it touches the store, applied safely, and reversible with one-click rollback if an edit is not right.

The companion **Rules Library** stores the Rules Profiles that govern how the AI edits. A Rules Profile defines voice, tone, length, schema structure, and forbidden-word constraints so every bulk edit matches your brand standards and respects your legal guardrails.

## The three actions

<CardGroup cols={3}>
  <Card title="Export to Grid" icon="table">
    Pull products, collections, or content into a spreadsheet-style grid and export as CSV.
  </Card>

  <Card title="Generate with AI Request" icon="sparkles">
    Apply a Rules Profile to thousands of rows in one batch. The AI edits according to your constraints.
  </Card>

  <Card title="Import File" icon="upload">
    Upload the edited CSV and review every change in the grid before deciding what to apply.
  </Card>
</CardGroup>

## The full workflow

<Steps>
  <Step title="Export to Grid">
    Open `/v2/actions` and click **Bulk Content Edit**, then choose **Export to Grid**.

    Select the entity type you want to edit: **Products**, **Collections**, or **Content**. Filter the export by collection, product type, tag, or any other dimension available in your connected storefront connector. The grid loads your selected entities with one row per product (or collection or content block) and one column per editable field - title, description, meta title, meta description, body HTML, and so on.

    When the grid looks right, click **Export CSV** to download the file. This CSV is the input to the next step.
  </Step>

  <Step title="Generate with AI Request">
    Click **Generate with AI Request** and upload your exported CSV, or work directly in the grid.

    Select the **Rules Profile** you want to apply. The Rules Profile defines:

    * **Voice** - the register and personality the AI writes in (e.g. confident, technical, conversational)
    * **Tone** - the emotional texture appropriate for your brand and audience
    * **Length** - minimum and maximum word counts per field
    * **Schema** - which schema.org fields to populate and in what format
    * **Forbidden words** - terms, competitor names, or claims the AI must never use

    Write your AI Request - for example, *Rewrite every product description to lead with the primary benefit, include the key specification in the second sentence, and end with a single call to action. Apply the brand voice from the Rules Profile.* - and click **Generate**.

    The AI processes every row in the CSV according to your request and your Rules Profile constraints. For large catalogues this runs as a background batch; you will see the job in the **Active Work** area at the bottom of the Vortex Agents hub.
  </Step>

  <Step title="Review in the grid">
    When the batch completes, the edited CSV is loaded back into the grid with a diff view showing the original value and the AI-generated replacement side by side for every changed field.

    Review the changes. You can:

    * Accept individual cells
    * Reject individual cells and keep the original
    * Edit a cell inline before accepting
    * Filter to rows with changes only
    * Filter to a specific field (e.g. review all `meta_description` changes before reviewing `body_html` changes)

    Nothing is applied to your store at this stage. The grid is a staging environment.
  </Step>

  <Step title="Import File">
    Click **Import File** (or **Apply changes** if you are working directly in the grid) to push the approved rows back to your storefront via the connected platform connector - Shopify, BigCommerce, or Adobe Commerce.

    Only the rows and fields you approved are written. Rejected cells keep their original values. The import is logged in Vortex Memory with a timestamp, the Rules Profile used, and the count of changes applied, so you have a full audit trail.
  </Step>
</Steps>

## Rules Profiles

A Rules Profile is the AI's brief for a bulk edit. Without one, the AI uses a neutral retail-friendly tone and flags that a brand voice would tighten the output. With one, every row in a thousand-product batch sounds like it came from the same writer who knows your brand.

### What a Rules Profile contains

| Constraint          | What it controls                                                                                       |
| ------------------- | ------------------------------------------------------------------------------------------------------ |
| **Voice**           | Register and personality - e.g. expert, friendly, authoritative, direct                                |
| **Tone**            | Emotional texture appropriate to your brand and audience                                               |
| **Length**          | Minimum and maximum word counts per field type                                                         |
| **Schema**          | Which schema.org properties to populate, in what format and order                                      |
| **Forbidden words** | Terms, competitor names, unsubstantiated claims, or regulatory no-go phrases the AI must never produce |

### Creating and managing Rules Profiles

Rules Profiles live in the **Rules Library**, accessible from the top-right of every Vortex Agents screen. Each profile has a name, a description, and the full set of constraints listed above.

<Note>
  Rules Profiles connect directly to the **Brand & AI settings tab** under Platform Settings. Brand voice rules you configure in Brand & AI cascade into every bulk operation that references a Rules Profile, so your guardrails are consistent across Bulk Content Edit, SEO content production, and AI-generated pages.
</Note>

You can create as many Rules Profiles as you need. Common setups:

* One profile per brand (if you manage multiple merchants)
* One profile per content type (product descriptions vs blog posts vs meta descriptions)
* One profile per locale (if voice or tone differs by market)

### Applying a Rules Profile from Ask Viq

You can trigger a bulk edit from the Ask Viq chat:

* *Rewrite all product descriptions in the Accessories collection using the UK Brand Voice profile*
* *Update meta descriptions for products with no meta description, apply Rules Profile: SEO Default*
* *Bulk edit all collection page descriptions to add a structured lead paragraph*

Ask Viq parses the request, confirms the scope and the Rules Profile it will use, and runs the Generate step. The result lands in the grid for review before anything is applied.

## What Bulk Content Edit does not do

Bulk Content Edit operates on **existing entities** - products, collections, and content already in your store. To propose entirely new pages or design changes optimised for sales, use [Generate New Page / Design Change](/actions/store-audit) from the Store Audit module.

## Cross-links

* Brand voice source: [Brand & AI settings](/platform/settings)
* Audit-driven edit triggers: [Store Audit](/actions/store-audit)
* SEO content production: [SEO + GEO Engine](/actions/seo-geo)
* Change history: [Vortex Memory](/vortex-memory)