Rename a Workflow

Change your workflow name to better organize and identify training configurations.

Why rename workflows?

Clear, descriptive workflow names help you:

  • Identify purpose — Quickly understand what each workflow trains
  • Organize configurations — Distinguish between experimental and production workflows
  • Track experiments — Use naming conventions for systematic testing
  • Collaborate effectively — Help team members understand workflow objectives

Example naming conventions:

Poor NameBetter NameBest Name
Untitled WorkflowPCB ModelPCB-Qwen2.5-7B-LoRA-v1
Workflow 1VQA ModelManufacturing-VQA-NVLM-8B
TestTest RunPCB-Detection-Experiment-LR0.001

Rename a workflow

Step 1: Open your workflow

Navigate to the Training project containing your workflow.

From the Workflows section, click the workflow you want to rename to open the workflow canvas.

💡

Quick access

You can also access workflows from the Runs section by clicking on any run, then selecting View Workflow.


Step 2: Click the workflow name

At the top of the workflow canvas, click on the current workflow name (e.g., "Untitled Workflow").

The name becomes editable with a text input field.


Step 3: Enter new name

Type your new workflow name in the text field.

Naming best practices:

  • ✅ Use descriptive names that indicate purpose: PCB-Component-Detection
  • ✅ Include key details: model architecture, task, or version: Vehicle-VQA-Qwen2.5-7B-v2
  • ✅ Use consistent naming conventions across workflows: {Domain}-{Task}-{Model}-{Version}
  • ❌ Avoid generic names: Workflow 1, Test, My Model
  • ❌ Don't use special characters that may cause issues: / \ : * ? " < > |

Step 4: Save the new name

Press Enter or click outside the text field to save your changes.

The workflow name updates immediately across:

  • Workflow canvas header
  • Workflows list
  • Associated training runs
  • Run history and logs

Changes saved automatically

Your new workflow name is saved instantly. No additional confirmation required.


Workflow name requirements

RequirementDetails
Length1-100 characters recommended
CharactersLetters, numbers, spaces, hyphens, and underscores
UniquenessNames don't have to be unique (but recommended for clarity)
Special charactersAvoid: `/ \ : * ? " < >`

Naming strategies

Strategy 1: Descriptive purpose-based names

Use clear descriptions of what the workflow trains:

Format: {Domain/Use-Case}-{Task-Type}

Examples:

  • PCB-Component-Detection
  • Automotive-Quality-Inspection
  • Medical-Image-VQA
  • Warehouse-Inventory-Tracking
  • Document-Understanding

When to use: General organization and team collaboration

Strategy 2: Technical specification names

Include model architecture and training mode details:

Format: {Domain}-{Model}-{Size}-{Training-Mode}

Examples:

  • PCB-Qwen2.5-7B-LoRA
  • Defects-NVLM-8B-FullFT
  • VQA-InternVL2.5-4B-LoRA
  • Grounding-Molmo-7B-LoRA

When to use: Comparing different model architectures or training approaches

Strategy 3: Experiment versioning names

Use versioning for systematic experimentation:

Format: {Base-Name}-{Experiment-Variable}-v{Version}

Examples:

  • PCB-Detection-LR0.001-v1
  • PCB-Detection-LR0.0001-v2
  • Vehicle-VQA-Batch16-v1
  • Vehicle-VQA-Batch32-v2
  • Manufacturing-3Epochs-v1
  • Manufacturing-5Epochs-v2

When to use: A/B testing and hyperparameter optimization

Strategy 4: Date-based versioning

Include dates for chronological tracking:

Format: {Domain}-{Task}-YYYYMMDD or {Domain}-{Task}-v{Version}-YYYYMMDD

Examples:

  • PCB-Detection-20250101
  • Defects-VQA-v3-20250115
  • Warehouse-Grounding-20250201

When to use: Long-term projects with frequent iterations


Common questions

Does renaming affect training runs?

No. Renaming a workflow doesn't affect:

  • Existing training runs (past or active)
  • Saved models and checkpoints
  • Run history or metrics
  • Associated datasets or configurations

All runs maintain their connection to the workflow regardless of name changes.

Can multiple workflows have the same name?

Yes. Workflow names don't have to be unique within a project.

However, we strongly recommend using unique names to:

  • Avoid confusion when selecting workflows
  • Make run history easier to navigate
  • Prevent accidental training with wrong configuration

If you need similar workflows, use versioning: PCB-Detection-v1, PCB-Detection-v2, etc.

Can I undo a rename?

Yes. Simply rename the workflow again to revert to the previous name.

There's no rename history, so if you want to track name changes, document them externally or include version numbers in your naming convention.

What happens if I use special characters?

The system accepts most characters, but certain special characters may cause issues:

Avoid these characters: / \ : * ? " &lt; &gt; |

These can cause problems with:

  • File system compatibility when downloading models
  • API integrations
  • Automated scripts and workflows

Safe to use: Letters, numbers, spaces, hyphens (-), and underscores (_)


Best practices

Use consistent naming conventions

Establish naming standards for your team or project:

Standard convention example:
{Project}-{Task}-{Model}-{TrainingMode}-v{Version}

PCB-Grounding-Qwen2.5-7B-LoRA-v1
PCB-Grounding-Qwen2.5-7B-LoRA-v2
PCB-VQA-NVLM-8B-FullFT-v1

Include key identifying information

Make it clear what makes this workflow unique:

  • Task type: Phrase grounding vs. VQA
  • Domain or use case: PCB inspection, defect detection, etc.
  • Model architecture: Qwen2.5, NVLM, InternVL2.5
  • Key parameters: Training mode, learning rate, batch size (for experiments)
  • Version or iteration: v1, v2, v3 or date stamps

Rename before starting runs

Rename workflows from "Untitled Workflow" before starting your first training run for clearer run history:

Poor workflow:

Untitled Workflow → Run 1, Run 2, Run 3

Good workflow:

PCB-Detection-Qwen2.5-7B-v1 → Run 1, Run 2, Run 3

This makes it immediately clear which configuration produced each run.

Update names when configuration changes significantly

If you modify a workflow substantially (e.g., changing model architecture or completely rewriting the system prompt), consider updating the name or incrementing the version:

Example evolution:

PCB-Detection-v1 (Original)
  ↓ (Changed model from Qwen 2B to 7B)
PCB-Detection-Qwen7B-v2
  ↓ (Switched to full fine-tuning)
PCB-Detection-Qwen7B-FullFT-v3

Related resources