Styles are used to control the appearance of geospatial data. Styles for GeoServer are written in Styled Layer Descriptor (SLD), a subset of XML. Please see the section on Styling for more information on working with styles.
On the Styles page, you can add a new style, view or edit an existing style, or remove a style.
Edit a Style¶
The Style Editor page presents options for configuring a style’s name, code, and other attributes. SLD names are specified at the top in the name field. The style’s workspace can be chosen using the workspace selector. Styles are edited using a plain text editor with some basic utilities.
The style editor supports line numbering, automatic indentation, and real-time syntax highlighting. You can also increase or decrease the font size of the editor.
|go to line|
|auto-format the editor contents|
|change the font size of the editor|
To confirm that the SLD code is fully compliant with the SLD schema, click the Validate button. A message box will confirm whether the style contains validation errors.
GeoServer will sometimes render styles that fail validation, but this is not recommended.
To view the generated legend entry for the style, click the Preview Legend button.
Add a Style¶
The buttons for adding and removing a style can be found at the top of the Styles page.
To add a new style, select the Add a new style button. You will be redirected to an editor page. Enter a name for the style. You can also select the style format. In a default GeoServer installation only SLD is supported, but other extensions (such as css) add support for additional formats. The editor page provides several options for submitting a new style. You can paste the style directly into the editor contents. You can generate a new default style based on an internal template:
You can copy the contents of an existing style into the editor:
You can select and upload a local file that contains the SLD:
Once a style is successfully submitted, you will be redirected to the main Styles page where the new style will be listed.
Remove a Style¶
To remove a style, select it by clicking the checkbox next to the style. Multiple styles can be selected, or all can be selected by clicking the checkbox in the header. Click the Remove selected style(s) link at the top of the page. You will be asked to confirm or cancel the removal. Clicking OK removes the selected style(s).
Add a Legend¶
By default GeoServer will generate a legend based on your SLD file. You can use the Add legend link to provide a custom legend.
Use Online Resource to reference one of the images in your styles folder. See Structure of the Data Directory for a description of the styles folder.
Use Width, Height and Format to describe your image or click Auto-detect image size and type to fill in these fields.
Use Discard legend to remove your custom legend and revert to legend generation based on your SLD file.