Wrap tag contents

The Wrap Tag Contents refactoring allows you to wrap the contents of a selected tag in a newly created tag. This bulk wrapping of tag contents may be useful as XML schemas evolve.

In the example below, you can wrap the contents of the <ratings></ratings> tag with a <votes></votes> tag, which will be created as a part of refactoring.

      <ratings average="5.9">
          86
      </ratings>
  

      <ratings average="5.9">
          <votes>86</votes>
      </ratings>
  

Wrap tag contents

Place the caret at the tag whoc contents you want to wrap, press Ctrl+Alt+Shift+T, and then select Wrap Tag Contents from the list.
In the dialog that opens, type the name of the wrapping tag to create and specify the scope to wrap the tag contents in.
- With the Directory scope specified, select the Recursively checkbox to include sub-directories.
- Select the Limit to files with DTD:... checkbox to limit the scope to the files with the same DOCTYPE as specified for the current file.
Invoke the refactoring:
- Click OK to continue immediately or click Preview to have WebStorm show the usages of the selected tag in the Find tool window where you can mark usages as included in or excluded from refactoring.
  The tool window may appear anyway if the refactoring may affect read-only files.
- Click Show XSLT... to view a fragment of the XSLT that is equivalent to the requested refactoring. This fragment can be used by XSLT processors to perform the requested refactoring on files outside your WebStorm project.

30 January 2026