GalleonQL Manual
Changelog

Renaming and creating folders

This page explains how to rename collection folders, saved queries, favorite folders, environments, and projects, and how to create a new collection folder. For terminology, see Key terms.

The controls are the same for all five kinds of item.

Prerequisites

  • Names are saved automatically and survive a restart.
  • Projects can be renamed too (all three ways in work, same as the other kinds of item).

Renaming

There are three ways in. They all do the same thing.

Way in Action
Double-click Double-click the name in the row
Keyboard Select the row and press F2
menu The on the right of the row → "Rename"

The name turns into a text field in place.

  • Enter confirms.
  • Esc cancels.
  • Clicking outside the field also confirms (so what you typed is not thrown away).

Leaving it empty keeps the name

If you clear the name and confirm, the original name stays (it is never replaced with something like "New folder"). The field also shows "Leaving it empty keeps the current name". Leading and trailing spaces are removed.

Duplicate names get a number

If the same name already exists in the same place, a number is added automatically (UsersUsers (2)). Before you confirm, the field shows "That name is taken, so it will become “Users (2)”", so you never end up with an unexpected name by surprise.

Where a duplicate is looked for depends on the kind of item:

Item Where duplicates are looked for
Collection folder Folders in the same place (may share a name with a query)
Saved query Queries in the same folder
Favorite folder All favorite folders
Environment Environments in the same project (may share a name with another project's environment)
Project All projects

An item's own name never counts as a duplicate, so confirming without changing anything never adds a number.

Creating a collection folder

There are three ways in. All of them open the same input: type a name and press Enter (or "Create") to create it, Esc to cancel. Creating follows the same rule as above — a duplicate name gets a number.

Entry point Where it is created
The + on the "Collection" heading The root (top level)
A row's → New folder For a folder row, inside that folder (a subfolder); for a query row, at the same level as that query
Right-click a row Opens the same menu as
Right-click empty space in the list The root

When you create a subfolder, the input appears directly under that folder's row, so you can see where it will go.

Favorite folders can be created from the + on the "★ Favorites" heading, or from / right-click on a favorite row. Favorite folders have no hierarchy (you cannot put a folder inside a folder), so they are always created at the top level. Use collection folders when you need deeper organization.

Tips

  • Renaming a starred query also changes its name in the collection (they are the same item seen from two places).
  • Renaming never changes a query's contents (body, headers, arguments) or its favorite status.
  • Renaming a saved query also updates the title of the tabs opened from it. Even if another folder holds a query with the same name, only the tabs opened from the query you renamed change (if the same query is open in several tabs, all of them change). Unsaved tabs created with are unaffected.
  • Rows cannot be reordered while you are editing (this stops a drag attempt from selecting text instead). For reordering, see Reordering and moving.
  • Double-clicking a row's name does not open the query, toggle the folder, or switch the environment. Only renaming starts.

What you cannot do at this point (limitations)

  • Field names in a query cannot be changed (they come from the schema).
  • A request tab's title cannot be edited directly (rename the saved query and the tab follows).

When things go wrong

Symptom Cause What to do
Double-click does not start editing The two clicks were too fast or too slow Use "Rename" in the menu, or F2
F2 does nothing No row is selected Click the row first (having pressed once also works)
A number was added The same name exists in the same place Check the table above; the field warns you before you confirm
The name did not change You confirmed with an empty field Type a name and press Enter
The name reverted Saving may have failed. If crash reporting is enabled, consider sending a report

Related documents