Queries

Common

Item Description

Align the first word of clause

Align keywords to the left or right margin of the first word of a statement section (for example, SELECT). The To left with indent option aligns all keywords except for WITH, UNION, and INTERSECT along the left margin with the indent.

To left	To left with indent	To right

Place clause elements on Move clause elements to a new line (New line) or leave them on the same line (Same line).

Place comma

Move a comma (,) to the beginning (To begin) or to the end (To end) of a code line.

The Auto option analyzes the surrounding context and calculates the most suitable place for a comma. For example, you have three occurrences of a comma: two commas go at the beginning, one comma is at the end. The Auto option will move the third occurrence of the comma to the beginning. This option works only if you have more than three cases in a single context. Otherwise, commas are left as is.

If you want to disable a new line after the comma when the To begin option is enabled, clear the Line breaks checkbox on the Wrapping tab.

Collapse short statements

Join multiline short statements. The length of a statement that will be collapsed is determined automatically by PhpStorm. To enable this option only for subqueries, select Subqueries only.

Keep section elements under section header Move all section elements under the section main keyword (a header).

Align section elements

Align elements of a clause section.

Off	On

Align line comments at right of elements Align line comments that are on the right side of code.

INSERT statement and VALUES clause

Item Description

Place INTO on the new line Move INTO and clause elements that follow INTO on a new line.

Place INTO clause elements on

Move clause elements that follow INTO on a new line.

The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.

Place VALUES clause elements (rows) on

Move clause elements that follow VALUES on a new line.

The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.

Place the opening parenthesis Align or indent the opening parenthesis under the first keyword on the line. Select On the same line to keep the opening parenthesis on the line with the keyword.

Place columns or values

Change the position of elements in relation to the opening parenthesis.

Same line aligned: align all members of the clause, keep the first member on the same line with a parenthesis.
Wrapped unindented: move all members of the clause to a new line without adding an indent.
Wrapped aligned: align and move all members of the clause to a new line.
Wrapped indented: add an indent and move all members of the clause to a new line.

Place the closing parenthesis

Change the position of the closing parenthesis.

At the end: place the closing parenthesis at the same line with the last element of a clause.
To begin: move the closing parenthesis to a new line with the last element of a clause.
Under opening: place the closing parenthesis under the opening parenthesis.
Under elements: place the closing parenthesis under aligned elements of a clause.

Wrap columns or values

Move objects to a new line.

Chop: move each value to a new line.
Chop if long: move each value to a new line if text exceeds the configured line length. To configure the line length, open settings Ctrl+Alt+S, navigate to Editor | Code Style, and type the necessary length in the Hard wrap at N columns field.
Wrap if long: break a section of text into lines so that each line fits the configured line length. To configure the line length, open settings Ctrl+Alt+S, navigate to Editor | Code Style, and type the necessary length in the Hard wrap at N columns field.

Place comma

Move a comma (,) to the beginning (To begin) or to the end (To end) of a code line.

If you want to disable a new line after the comma when the To begin option is enabled, clear the Line breaks checkbox on the Wrapping tab.

To begin	To end

The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab..

Put spaces within parentheses Add a space after the opening parenthesis and before the closing parenthesis.

Collapse short multi-row values

Place all statements on a single line.

UPDATE statement

Item	Description
Place elements on	Move clause elements to a new line (New line) or leave them on the same line (Same line). The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.
Wrap elements	Move elements to a new line. Chop: move each value to a new line. Chop if long: move each value to a new line if text exceeds the configured line length. To configure the line length, open settings `Ctrl+Alt+S`, navigate to Editor \| Code Style, and type the necessary length in the Hard wrap at N columns field. Wrap if long: break a section of text into lines so that each line fits the configured line length. To configure the line length, open settings `Ctrl+Alt+S`, navigate to Editor \| Code Style, and type the necessary length in the Hard wrap at N columns field.
Place comma	Move a comma (`,`) to the beginning (To begin) or to the end (To end) of a code line. The Auto option analyzes the surrounding context and calculates the most suitable place for a comma. For example, you have three occurrences of a comma: two commas go at the beginning, one comma is at the end. The Auto option will move the third occurrence of the comma to the beginning. This option works only if you have more than three cases in a single context. Otherwise, commas are left as is. If you want to disable a new line after the comma when the To begin option is enabled, clear the Line breaks checkbox on the Wrapping tab. The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.
Align `=`	Align all equal signs (`=`).

WITH clause

Item Description

Place elements on

Move clause elements to a new line (New line) or leave them on the same line (Same line).

The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.

Wrap subqueries

Move elements to a new line.

Chop: move each value to a new line.
Chop if long: move each value to a new line if text exceeds the configured line length. To configure the line length, open settings Ctrl+Alt+S, navigate to Editor | Code Style, and type the necessary length in the Hard wrap at N columns field.

Place comma

Move a comma (,) to the beginning (To begin) or to the end (To end) of a code line.

The In the middle option joins two lines of code on one line.

If you want to disable a new line after the comma when the To begin option is enabled, clear the Line breaks checkbox on the Wrapping tab.

The Place comma option works only if the Wrap subqueries option in the WITH clause section is set to Chop or Chop if long.

The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.

To begin	In the middle	In the end

Align AS

Align all AS keywords.

SELECT clause

Item	Description
Place elements on	Move clause elements to a new line (New line) or leave them on the same line (Same line). The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.
Wrap elements	Move elements to a new line. Chop: move each value to a new line. Chop if long: move each value to a new line if text exceeds the configured line length. To configure the line length, open settings `Ctrl+Alt+S`, navigate to Editor \| Code Style, and type the necessary length in the Hard wrap at N columns field. Wrap if long: break a section of text into lines so that each line fits the configured line length. To configure the line length, open settings `Ctrl+Alt+S`, navigate to Editor \| Code Style, and type the necessary length in the Hard wrap at N columns field.
Place comma	Move a comma (`,`) to the beginning (To begin) or to the end (To end) of a code line. The Auto option analyzes the surrounding context and calculates the most suitable place for a comma. For example, you have three occurrences of a comma: two commas go at the beginning, one comma is at the end. The Auto option will move the third occurrence of the comma to the beginning. This option works only if you have more than three cases in a single context. Otherwise, commas are left as is. If you want to disable a new line after the comma when the To begin option is enabled, clear the Line breaks checkbox on the Wrapping tab. The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.
New line after ALL, DISTINCT	Add a new line after ALL and DISTINCT.
Keep elements on one line if ≤	Set the maximum number of elements on one line.
Use AS	Always use AS for aliases.
Align AS	Align all AS keywords.

FROM clause

Item	Description
Place elements on	Move clause elements to a new line (New line) or leave them on the same line (Same line). The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.
Wrap elements	Move elements to a new line. Chop: move each value to a new line. Chop if long: move each value to a new line if text exceeds the configured line length. To configure the line length, open settings `Ctrl+Alt+S`, navigate to Editor \| Code Style, and type the necessary length in the Hard wrap at N columns field. Wrap if long: break a section of text into lines so that each line fits the configured line length. To configure the line length, open settings `Ctrl+Alt+S`, navigate to Editor \| Code Style, and type the necessary length in the Hard wrap at N columns field.
Place comma	Move a comma (`,`) to the beginning (To begin) or to the end (To end) of a code line. The Auto option analyzes the surrounding context and calculates the most suitable place for a comma. For example, you have three occurrences of a comma: two commas go at the beginning, one comma is at the end. The Auto option will move the third occurrence of the comma to the beginning. This option works only if you have more than three cases in a single context. Otherwise, commas are left as is. If you want to disable a new line after the comma when the To begin option is enabled, clear the Line breaks checkbox on the Wrapping tab. The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.
Wrap the first JOIN	Move the first JOIN in the SELECT statement to a new line.
Wrap the next JOIN	Move the second JOIN in the SELECT statement to a new line.
Indent JOIN	Add an indent before the JOIN clause.
Place JOIN in join-only queries under	Select the element according to which you want to align the JOIN clause. Table (as usual): align to the table name. FROM indented: align to the right margin of FROM with an indent. FROM indented: align to the left margin of FROM.
Align joined tables	Align table names in JOIN clauses.
Align table aliases	Align table aliases in JOIN clauses.
Wrap ON/USING	Move ON and USING to a new line.
Place ON/USING under	Align ON and USING to the table name (Table), or align to the table name and add an indent (Table indented).

WHERE and HAVING clauses

Item	Description
Place elements on	Move clause elements to a new line (New line) or leave them on the same line (Same line). The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.
Wrap elements	Move elements to a new line. Chop: move each value to a new line. Chop if long: move each value to a new line if text exceeds the configured line length. To configure the line length, open settings `Ctrl+Alt+S`, navigate to Editor \| Code Style, and type the necessary length in the Hard wrap at N columns field. Wrap if long: break a section of text into lines so that each line fits the configured line length. To configure the line length, open settings `Ctrl+Alt+S`, navigate to Editor \| Code Style, and type the necessary length in the Hard wrap at N columns field.
Place top-level AND/OR	Move AND and OR to the end (To end) or to the beginning (To begin) of a clause.
Align AS	Align all AS keywords.

GROUP BY and ORDER BY clauses

Item	Description
Place elements on	Move clause elements to a new line (New line) or leave them on the same line (Same line). The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.
Wrap elements	Move elements to a new line. Chop: move each value to a new line. Chop if long: move each value to a new line if text exceeds the configured line length. To configure the line length, open settings `Ctrl+Alt+S`, navigate to Editor \| Code Style, and type the necessary length in the Hard wrap at N columns field. Wrap if long: break a section of text into lines so that each line fits the configured line length. To configure the line length, open settings `Ctrl+Alt+S`, navigate to Editor \| Code Style, and type the necessary length in the Hard wrap at N columns field.
Place comma	Move a comma (`,`) to the beginning (To begin) or to the end (To end) of a code line. The Auto option analyzes the surrounding context and calculates the most suitable place for a comma. For example, you have three occurrences of a comma: two commas go at the beginning, one comma is at the end. The Auto option will move the third occurrence of the comma to the beginning. This option works only if you have more than three cases in a single context. Otherwise, commas are left as is. If you want to disable a new line after the comma when the To begin option is enabled, clear the Line breaks checkbox on the Wrapping tab. The As in common option means that the behavior of the selected option must duplicate the behavior of the analogous option in the Common section on the Queries tab.
Align ASC/DESC	Align all ASC and DESC keywords.

Subquery

Item	Description
Place the opening parenthesis	Align or indent the opening parenthesis under the first keyword on the line. Select On the same line to keep the opening parenthesis on the line with the keyword.
Place subquery	Change the position of elements in parentheses. Same line aligned: align all members of the clause, keep the first member on the same line with a parenthesis. Wrapped unindented: move all members of the clause to a new line without adding an indent. Wrapped aligned: align and move all members of the clause to a new line. Wrapped indented: add an indent and move all members of the clause to a new line.
Place the closing parenthesis	Change the position of the closing parenthesis. At the end: place the closing parenthesis at the same line with the last element of a clause. Unindented: move the closing parenthesis to a new line without an indent. To begin: move the closing parenthesis to a new line with the last element of a clause. Under opening: place the closing parenthesis under the opening parenthesis. Under elements: place the closing parenthesis under aligned elements of a clause.
Put spaces within parentheses	Add a space after the opening parenthesis and before the closing parenthesis.

Last modified: 08 March 2021