# Customization

<details>

<summary>Media</summary>

<img src="https://2650739216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnVmamp3TnQON29mRg6Hg%2Fuploads%2FWBAgdHxO538vqQG8EC3p%2Fvecteezy_light-bulb-icon_6757532.jpg?alt=media&#x26;token=f7283bd4-81e3-4d9a-b5e3-f594d233421f" alt="" data-size="line">[Add Fields/Sections/Tabs](https://howto.salesorder.com/add-new-fields-sections-tabs/)

<img src="https://2650739216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnVmamp3TnQON29mRg6Hg%2Fuploads%2FWBAgdHxO538vqQG8EC3p%2Fvecteezy_light-bulb-icon_6757532.jpg?alt=media&#x26;token=f7283bd4-81e3-4d9a-b5e3-f594d233421f" alt="" data-size="line">[Setup and Enable Payment Processors](https://howto.salesorder.com/setup-and-enable-payment-processors/)

<img src="https://2650739216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnVmamp3TnQON29mRg6Hg%2Fuploads%2FNGreHwiLAuodWVITv9QN%2Fimage.png?alt=media&#x26;token=473d689c-f08a-4aa4-b040-928a8e20dbee" alt="" data-size="line">[Customize Part 1 - Adding Fields](https://app.storylane.io/share/v92vnkxowz4y)

<img src="https://2650739216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnVmamp3TnQON29mRg6Hg%2Fuploads%2F3q39FIqx6D2JJsLC18W1%2Fimage.png?alt=media&#x26;token=3f0bcf46-f5c6-4dbe-bf7d-fc5aec87f640" alt="" data-size="line">[Customize Part 2 - Tabs and Sections](https://app.storylane.io/share/ykhm3ndkabbb)

<img src="https://2650739216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnVmamp3TnQON29mRg6Hg%2Fuploads%2FCL2SazH3HiNTbzXAD4Zu%2Fimage.png?alt=media&#x26;token=bee398f6-ee37-4fd3-a303-7a849be86364" alt="" data-size="line">[Customize Part 3 - Altering and Inheriting Fields](https://app.storylane.io/share/are5sbacjojp)

</details>

### Customization - need to know <a href="#cga5si7gywxv" id="cga5si7gywxv"></a>

Salesorder was architected to be customized.&#x20;

If you cannot achieve the customization with the functions described below, we’ll work with you to understand and turn your requirements into Plugins.&#x20;

Plugins are scripts written by developers to extend or add functionality.

Because of the efficiency of the software development tools we use, Plugins can be delivered quickly and, therefore at a relatively low cost. Please contact <support@salesorder.com> for more information.

### What you can do here <a href="#u5lfbz1tfq90" id="u5lfbz1tfq90"></a>

Use the links to navigate to the instructions on this page.

| [<mark style="color:blue;">Insert Custom field</mark>](#_xlsevl7ga7d6) | [<mark style="color:blue;">Add Section</mark>](#add-section)      | [<mark style="color:blue;">Add Tab</mark>](#add-tab)       |
| ---------------------------------------------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------- |
| [<mark style="color:blue;">Move Custom field</mark>](#_15by5a3cxz9w)   | [<mark style="color:blue;">Move Section</mark>](#_kybf2kilcuo7)   | [<mark style="color:blue;">Move Tab</mark>](#move-tab)     |
| [<mark style="color:blue;">Delete Custom field</mark>](#_rm90uvg4rr7d) | [<mark style="color:blue;">Delete Section</mark>](#_k8xxgpe1udwh) | [<mark style="color:blue;">Delete Tab</mark>](#delete-tab) |
| [<mark style="color:blue;">Inherit Field value</mark>](#_9wjbzbmd45hy) |                                                                   |                                                            |

You can personalize Document screens by inserting custom fields or hiding the standard ‘out of the box’ fields. You can make standard and custom fields mandatory.

Custom fields let you add and store more data to Document screens.

### Custom Field Types:

| Field type     | Function                                                       |
| -------------- | -------------------------------------------------------------- |
| Text           | A simple text field.                                           |
| Area of Text   | A text area for multiple line notes.                           |
| Check Box      | Checked or unchecked box.                                      |
| List           | A dropdown list. Add value to a list and make them selectable. |
| Number         | A round number                                                 |
| Decimal Number | i.e. 1.0908                                                    |
| Date           | Date selector                                                  |
| Money          | An amount and currency.                                        |
| Button         | Not in use.                                                    |
| Link           | Space for a website link.                                      |

### Field inheritance

Documents can inherit values from custom fields, i.e. a custom field on a Sales Quote can be inherited by a custom field on a Sales Order.

### Lists and Reports

Lists and Reports: Custom fields you add are available in Lists and Reports in the respective search and filter functions.

### Import data into custom fields

Add the ‘Field name’ (not the Label name) as a column in the respective Import spreadsheet. The Field name is defined in the ‘Insert Custom field’ dialogue. See below ‘Insert new field’.

To organize or create more space for new fields, you can add new sections and tabs.

* A section is a horizontal row that expands appropriately to hold the fields you add with it.
* A tab is a new area within which you can add new sections.

### **Modify existing fields**

You cannot remove standard (out of the box) fields on Documents, but you can hide or make them mandatory.

### I**nsert new fields**

Inserting new fields into the app is easy. You can add new custom fields to any Document where you see the ‘Configure’ button on the respective Document Action bar. When you add a custom field, it is available to everyone who has permission to access the modified Document screen.

**Permission to insert Custom fields?:** You need to have an Administrator Role on your login.

### Insert custom field <a href="#xlsevl7ga7d6" id="xlsevl7ga7d6"></a>

You can insert fields into the Document as is or create new Sections or Tabs *with sections,* then insert your fields. (You might want to do this latter step first)

1. Go to the Document you want to customize and click ‘Configure’
2. *Document* configuration, click ‘Customize fields’
3. Tell the app where you want to insert the new field by highlighting (mouse over and click) an existing field. For example:

| ![](https://2650739216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnVmamp3TnQON29mRg6Hg%2Fuploads%2FHZlZhCn9dZfQPi14VBHk%2F0?alt=media) Owner |   |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |

1. Click on ‘Edit Fields’
2. ‘Add Field…’
3. The ‘Insert Custom field’ dialogue box will appear.
4. Choose the ‘Field type’ [See Custom field types for detailed information](https://drive.google.com/a/salesorder.com/open?id=15mjC8w0mOd16mZEKoQh8oOo6tE53wRmX0yA-uR5237Y)
5. Click ‘OK’ to complete.

### Move custom field: <a href="#id-15by5a3cxz9w" id="id-15by5a3cxz9w"></a>

1. Go to the Document you want to customize and click ‘Configure’
2. *Document* configuration, click ‘Customise fields’
3. Tell the app which field you want to move by highlighting (mouse over and click) an existing field. For example:

| ![](https://2650739216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnVmamp3TnQON29mRg6Hg%2Fuploads%2FkC66dnoLEPXFZJO6RCyU%2F1?alt=media) my custom field |   |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |

1. Click on ‘Edit Fields’
2. ‘Move Field…’

### Delete custom field: <a href="#rm90uvg4rr7d" id="rm90uvg4rr7d"></a>

When you delete a custom field ALL data stored on this field is deleted and cannot be recovered.

1. Go to the Document you want to customize and click ‘Configure’
2. *Document* configuration, click ‘Customise fields’
3. Tell the app the field you want to delete by highlighting (mouse over and click) the target field. For example:

| ![](https://2650739216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnVmamp3TnQON29mRg6Hg%2Fuploads%2FM0T1wsDPO6axIp2f5sgD%2F2?alt=media) ‘my custom field’ |   |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |

1. Click ‘Edit Fields’ > ‘Delete’

### Inherit field value: <a href="#id-9wjbzbmd45hy" id="id-9wjbzbmd45hy"></a>

Strategy: Target a custom field on a Document you need to be populated by a value in a custom field on a preceding Document in a workflow. For example:

* A value in a custom field on a Sales Quote is inherited by a custom field on a Sales Order when it is created from the Sales Quote.
* A value in a custom field on a Customer is inherited by a custom field on a Sales Order when it is created from the Customer.

Before you begin: you will need to insert a pair of custom fields. One on the source Document and one on the inheriting Document.

1. Go to the Document you want to customize and click ‘Configure’
2. *Document* configuration, click ‘Customise fields’
3. Tell the app which custom field (A) you want another custom field (B) on the other ‘target’ Document to inherit from by highlighting (mouse over and click) an existing field. For example:

| ![](https://2650739216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnVmamp3TnQON29mRg6Hg%2Fuploads%2F3VpbRlRdzLvKiAcaU2Iz%2F3?alt=media) ‘my custom field’ |   |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |

1. Click on ‘Edit Fields’, then click on ‘Inherit field value’
2. On the ‘Specify Inherited Fields’ screen, you will see:

This is the field you will use in the target document and the custom field will inherit from

![](https://2650739216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnVmamp3TnQON29mRg6Hg%2Fuploads%2Ff3QHNAaCz14xJtXijXUg%2Fimage.png?alt=media\&token=a2f106b9-533e-4ab0-93b2-4ae52ad62076)

In this table, check the respective ‘Inherit’ box.

![](https://2650739216-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnVmamp3TnQON29mRg6Hg%2Fuploads%2FzOTgcqtXlor71BuEtiFd%2Fimage.png?alt=media\&token=3fef5852-455d-4181-9286-ebaf1d92466a)

1. Click ‘Save’
2. Go and test.

### Add Section:

To organize fields or make more space on the existing Document screen, you can add Sections or Tabs. You can add sections within Tabs. You can apply Headers to Sections.

1. Go to the Document you want to customize and click ‘Configure’
2. *Document* configuration, click ‘Customise fields’
3. Click ‘Edit Sections.
4. The next action will add a Section at the top of the Tab you have open. The Tab open by default is the left-most Tab. So make sure you select which Tab you want the new Section to be added to.
5. Click ‘Add Section…’
6. The app will add the Section.

When you add a Section, you may want to organize its contents under Headers. To add Headers:

1. Click ‘Add Header….

### Move Section: <a href="#kybf2kilcuo7" id="kybf2kilcuo7"></a>

1. Go to the Document you want to customize and click ‘Configure’
2. *Document* configuration, click ‘Customise fields’
3. Click on the ⚪ in the Section to select it.
4. Click Edit Sections > Move...

### Delete Section: <a href="#k8xxgpe1udwh" id="k8xxgpe1udwh"></a>

Deleting a Section will delete all fields within the Section together with all data previously stored in the respective fields. This is unrecoverable.

1. Go to the Document you want to customize and click ‘Configure’
2. *Document* configuration, click ‘Customise fields’
3. Click on the ⚪ in the Section to select it.
4. Click Edit Sections > Delete

### Add Tab:

You can move a Tab to the left or right

1. Go to the Document you want to customize and click ‘Configure’
2. *Document* configuration, click ‘Customise fields’
3. Click ‘Edit Tab’ > Add Tab
4. Give the Tab a useful name

### Move Tab:

You can move a Tab to the left or right

1. Go to the Document you want to customize and click ‘Configure’
2. *Document* configuration, click ‘Customise fields’
3. Click ‘Edit Tab’ > Move Tab...

### Delete Tab:

Deleting a Tab will delete all Sections fields within the Sections on the Tabs together with all data previously stored in the respective fields. This is unrecoverable.

1. Go to the Document you want to customize and click ‘Configure’
2. *Document* configuration, click ‘Customise fields’
3. Select the Tab you want to delete
4. Click ‘Edit Tab’ > Delete Tab...
