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

# Processor Reordering

> Change the execution order of processors within a Sawmills pipeline using drag-and-drop or move buttons to optimize cost, latency, and data quality.

## Processor Reordering Feature Documentation

## Overview

Normally when a processor is created, it gets added to the end of the execution order.  The Processor Reordering feature allows users to change the execution order of processors within a destination pipeline. Processors are executed sequentially in the order they appear, so reordering them can significantly impact data processing behavior.

> ℹ️ **Why Reordering Matters**\
> Reordering lets you optimize cost and/or latency without redeploying collectors. Changes both persist immediately and propagate to live traffic.

### Key Concepts

* **Processors** execute in sequential order (top to bottom)
* **Robust Algorithm** Only changes processors you've moved, maintains stable ordering
* **Real-time Updates** changes apply immediately to live data
* **Audit Logging** tracks all reordering operations with before/after states

***

## User Guide

### How to Reorder Processors (UI)

#### 1. Open the Reorder Drawer

* Navigate to the Processors list
* Find the destination you want to reorder processors for
* Click the "Reorder" button for that destination **or** you can click Reorder Processor from a processor's Action menu
* A drawer will slide in from the right showing all processors for that destination

#### 2. Reorder Using Drag & Drop

* **Drag Handle**: Click and hold the ⋮⋮ icon on the left of any processor
* **Drag**: Move the processor up or down to the desired position.  The page will scroll automatically if you drag near the top or bottom of the list.
* **Drop**: Release to place it in the new position

#### 3. Reorder Using Move Buttons

* **Move to Top** ⇈ - Jump to first position
* **Move Up** ⇑ - Move up one position
* **Move Down** ⇓ - Move down one position
* **Move to Bottom** ⇊ - Jump to last position
* **Visual Feedback**: The row will pulse/highlight when successfully moved

#### 4. Save Changes

* **Cancel** button - Discards all changes and closes drawer
* **Save** button - Opens confirmation modal
* **Confirm** - Applies changes immediately to live data
* Changes are visible immediately across the platform

***

## Activity Log

Every reorder triggers an activity log entry you can review in the Audit Log UI.

What you’ll see:

* **Before order:** full list of processors in their original positions.
* **After order:** the updated list immediately after you save.
* **Moves summary:** only the processors that changed position, showing the old and new index.
* **Metadata:** pipeline, destination, who made the change, and when it happened.