---
sourceDocument: Brazil Sales Customer Relationship Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/order-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Sales Customer Relationship Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# CSV layout upload

# CSV layout upload {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of CSV layout upload

This guide explains how to create, upload, and manage layout specifications for blueprints in ServiceNow CPQ using CSV files.
Layouts control how information is organized and displayed to end users on the buyside UI.
Multiple layouts can be defined per blueprint, allowing users to switch views via an alternate layout button.
Show full answer Show less  
ServiceNow recommends building layouts in spreadsheet software (e.g., Google Sheets or Excel) and exporting as CSV files for easy administration. Layouts are accessed and edited via the blueprint administration page or the Layout Wizard within the ServiceNow CPQ Admin interface.

## Creating and Editing Layouts

* Navigate to Blueprints, select the desired blueprint, and open the Layouts tab.
* Create a new layout or edit an existing one; layouts can be imported from or exported to CSV files.
* When uploading a CSV, errors will be displayed if the file contains issues.
* Changes to layouts require redeploying the blueprint to appear on the buyside UI.

## CSV Layout File Format

The CSV file defines layout components and their properties with specific columns and values:

* **type**: Defines layout components such as tiers (pages, tabs, accordions), column sets, images, product lists, and fields.
* **path**: Visual guide for element placement; not used by the application and should be left empty.
* **label**: Display labels for tiers and fields as seen by end users.
* **variablename**: Unique identifiers for tiers or fields; must be distinct for tiers.
* **component display type**: Specifies how fields are rendered, including text, picklists, radio buttons, sliders, checkboxes, and more, with many display variants.
* **columnorder**: Controls field order within column sets, helping responsive UI layout.
* **classname**: References predefined CSS classes in ServiceNow CPQ for layout styling and behavior, such as grid positioning, height, width, and special display effects.
* **value**: Contains JSON strings for additional properties like placeholder text in fields.

## Styling and Classes

The layout CSV supports various CSS classes that influence grid placement, size, alignment, and visibility of fields and images. Examples include:

* **Grid classes**: Define grid-column and grid-row placement for responsive layouts.
* **Height and width classes**: Set maximum height and width in rem units.
* **Picklist display classes**: Control vertical layout, alignment, and label visibility.
* **Override classes**: Enable customization such as forcing normal image display even when options are disabled.

## Additional Notes

* An alternative JSON-based layout editing method exists, which requires REST API uploads and disables CSV editing for that layout.
* Sample CSV files and instructional videos are available to help understand the layout format and its application.
* After editing and uploading layouts, redeploy the blueprint to see UI changes reflected on the buyside.  
Learn how to create and upload a CSV file that contains a layout specification.

Layouts are defined in a blueprint. When more than one layout is defined for a blueprint, end users rotate through them using the alternate layout button in the upper-right corner of the buyside UI.

Layouts are defined via CSV file that contains all instructions for the layout. For ease of administration, we recommend that admins build their layout in a spreadsheet (Google Sheets, Microsoft Excel, or similar) and export to CSV
format.

## Creating and editing a layout {#csv_layout_upload__section_hyn_cnn_bhc}

Access a layout from its corresponding blueprint administration page.

1. In the ServiceNow CPQ Admin navigation pane, click Blueprints (2).
2. Click the Layouts tab (3).
3. Click the name of the blueprint you want to access.

{#csv_layout_upload__ol_ygg_pkn_bhc}


To start a new layout, click Create Layout. To edit an existing layout, click the name of a layout in the list.

You can also edit a layout in the Layout Wizard. After you redeploy your blueprint, the new UI changes appear on the buyside.

When you begin a new layout, the New Layout window opens. You can import a CSV file by dropping it in the box or click to select it from your computer. (i) You can also download a sample layout file for your reference. (ii)

[Sample layout file](https://drive.google.com/file/d/1lzNW_jGkdzdUGwm9rh8xL9BeSxhv3MEJ/view?usp=sharing)

When you edit an existing layout:

Click Export to download the current layout file. (a)

Import a layout CSV file by clicking Replace (b).

Click Save (c) to replace the current layout with the edited layout. If CSV file upload fails, all errors found in the file will be shown to the administrator in an error dialog.


## Using layout CSV file upload {#csv_layout_upload__section_c13_2nn_bhc}

For a thorough introduction to the layout CSV format, view the following 26-minute video:

[Layout CSV Overview](https://drive.google.com/file/d/1htNUPvKa168ZdBF6qXeyIEbTGJljvlyg/view?usp=sharing)

For an example of how a layout CSV is used, view the following 4-minute video:

[HiTech Layout Overview](https://drive.google.com/file/d/1sVs53kC6CBvRRbgqDD12Bq0ofwKI36Rd/view?usp=sharing)

Download the corresponding HiTech Layout CSV file:

[HiTech layout CSV file](https://drive.google.com/file/d/10soQrWkXtQajYb8bce68slzFxgMvmRTX/view?usp=sharing)

## Layout CSV format {#csv_layout_upload__section_lw1_knn_bhc}

Column headings are lower case.

The type column defines the layout components. The following table shows valid values for this column.
{#csv_layout_upload__table_fyb_srn_bhc__entry__2}

| Type value | Description |
|-|-|
| tierDef | Properties: Pages, PagesWithLabels, PagesWithNavigation, ExpandableSection, Tab, TabWithNavigation, VerticalTab, VerticalTabWithNavigation, Accordion, AccordionWithNavigation |
| tier |   |
| columnset |   |
| image |   |
| productlist |   |
| productlistcolumn |   |
| field |   |
[Table 1. Valid values for the type column]

{#csv_layout_upload__table_fyb_srn_bhc}

The path column value format gives a visual cue to the placement of the element override source label, and is not currently used by the application. Leave it empty.

`label` defines the label to display to the end-user in the UI for tiers and fields.  
`variablename` defines a unique identifier for a tier or field.

* For tiers, administrator should define distinct values.
* For fields, populate the field variable name.
{#csv_layout_upload__ul_ejw_ynn_bhc}

The component display type column defines how a field should be displayed. The following types are available.
{#csv_layout_upload__table_xqt_fyn_bhc__entry__2}

| Field type | Component display types |
|-|-|
| Text | ReadOnlyText Text TextArea Date |
| Boolean | Boolean Radio RadioButtons |
| Number | Number Slider NumberWithSubmit ReadOnlyText ReadOnlyCurrency FormattedNumber |
| Picklist (single-select) | Extended picklist Extended picklistDisplayOnly Picklist ReadOnly picklist Radio RadioButtons SingleSelect picklistGrid VerticalRadio VisualPicker |
| Picklist (multi-select) | MultiSelectExtended picklist MultiSelectExtended picklistDisplayOnly MultiSelect picklist MultiSelect picklistGrid MultiSelectVisualPicker Checkbox VerticalCheckbox |
[Table 2. Component display types]

{#csv_layout_upload__table_xqt_fyn_bhc}

`columnorder` is relevant for components in a column set. Used to provide the sort order of the Fields based on screen resolution in the responsive UI.

`classname` is used to reference predefined classes available in ServiceNow CPQ. For example, when placing an image, a class can define the flow of fields around that image. Add these class names to the layout CSV file in the className column. As max-height and grid controls interact
with the width of the browser, we recommend you experiment with each class distinctly, exploring how the class responds to a variety of browser sizes.
{#csv_layout_upload__table_z23_xkb_nhc__entry__4}

| Effect | Applies to | Supported classes | Notes and examples |
|-|-|-|-|
| Grid | Fields, Images | topleft1col1row, topleft1col2row ... topleft1col6row | topleft1col1row { grid-column: 1/2; } topleft1col2row { grid-column: 1/2; grid-row: 1/3; } topleft1col3row { grid-column: 1/2; grid-row: 1/4; } topleft1col4row { grid-column: 1/2; grid-row: 1/5; } topleft1col5row { grid-column: 1/2; grid-row: 1/6; } topleft1col6row { grid-column: 1/2; grid-row: 1/6; } |
| Grid | Fields, Images | topleft2col1row, topleft2col2row ... topleft2col6row | topleft2col1row { grid-column: 1/3; } topleft2col2row { grid-column: 1/3; grid-row: 1/3; } topleft2col3row { grid-column: 1/3; grid-row: 1/4; } topleft2col4row { grid-column: 1/3; grid-row: 1/5; } topleft2col5row { grid-column: 1/3; grid-row: 1/6; } topleft2col6row { grid-column: 1/3; grid-row: 1/6; } |
| Grid | Fields, Images | topleft3col1row, topleft3col2row ... topleft3col6row | topleft3col1row { grid-column: 1/4; } topleft3col2row { grid-column: 1/4; grid-row: 1/3; } topleft3col3row { grid-column: 1/4; grid-row: 1/4; } topleft3col4row { grid-column: 1/4; grid-row: 1/5; } topleft3col5row { grid-column: 1/4; grid-row: 1/6; } topleft3col6row { grid-column: 1/4; grid-row: 1/6; } |
| Grid | Fields, Images | topright1col1row, topright1col2row ... topright1col6row | topright1col1row { grid-column: -2/-1; } topright1col2row { grid-column: -2/-1; grid-row: 1/3; } topright1col3row { grid-column: -2/-1; grid-row: 1/4; } topright1col4row { grid-column: -2/-1; grid-row: 1/5; } topright1col5row { grid-column: -2/-1; grid-row: 1/6; } topright1col6row { grid-column: -2/-1; grid-row: 1/6; } |
| Height | Fields | mh5, mh10, mh15 ... mh40 | Maximum height from 5 rem to 40 rem, in increments of 5 |
| Width | Fields | w5, w10, w15 ... w40 | Maximum width from 5 rem to 40 rem, in increments of 5 |
| Grid column width | Fields | lc-15m-15max, lc-15m-20max, lc-15m-25max, lc-15m-30max | These classes set the width of the columns in the layout grid. * lc: layout column * 15m: width of 15 rem * 15max: maximum width of 15 rem {#csv_layout_upload__ul_mp5_fpb_nhc} |
| Display vertically, align center | Picklist Fields | vertical-layout, align-center | Default: horizontal (when layout is vertical, default is left) |
| Hide field label, hide field option label | Display components: Extended picklist, MultiSelectExtended picklist | hide-field-label, hide-field-option-label |   |
[Table 3. Effects classes]

{#csv_layout_upload__table_z23_xkb_nhc}

The value column contains a JSON string to represent properties for element (Field or productlistcolumn) referenced on that row.

`placeholder` allows the Admin to define placeholder text that will display in a text field until the end-user inputs a value.

## Components with images {#csv_layout_upload__section_pp5_2rn_bhc}

For picklist display components that include images, when options are disabled, the image is faded. Admins can override this behavior and force the image to look normal by applying the `override-disabled` class to
the classname field in the layout.  
Note:  
An earlier means of defining and editing layouts using JSON is available. When leveraging JSON, the files must be loaded into the application via REST API. Once a layout has been edited via JSON, CSV manipulation is no longer available. If a layout has been edited via JSON, the Current Layout button is disabled.
**Related concepts**   

* [Layout Wizard](https://servicenow-prod.fluidtopics.net/jqaC_8UNIIZKVRe4GRAkHg "Watch a video about how to generate a layout.")
* [Layout editor](https://servicenow-prod.fluidtopics.net/tbsG54Pl5aeHRgFOCIkOGQ "Learn how to use the layout editor to modify a layout without leaving ServiceNow CPQ.")
* [Configure the Matrix Loader](https://servicenow-prod.fluidtopics.net/kRQN5xOB8TsNqFHIgYdyig "Use the Matrix Loader to efficiently add, edit, and migrate fields, field options, rules, and layouts in ServiceNow CPQ. Upload CSV files, validate configurations, and streamline bulk updates or environment migrations with error-handling and verification support.")

