> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Code structure (syntax)

CRMScript has a set of rules that dictate how you can and can't write your code. Conventions and best practices expand on the formal syntax.

You can learn all the basic codes structures here in the fundamentals. Then check out the code quality section, learn more about the data types, dive into the advanced topics, and look up the built-in classes and functions as needed.

## Backward compatibility

CRMScript is a language under continuous improvements. Some changes might alter the behavior of the script. To account for this, the **setLanguageLevel** setting indicates which compatibility level the script should run as.

```crmscript theme={null}
#setLanguageLevel 3;
```

| Level | SuperOffice version      | Description                                             |
| :---: | :----------------------- | :------------------------------------------------------ |
|   1   |                          | Obsolete                                                |
|   2   | version 6 and earlier    | Compatibility layer added for later versions            |
|   3   | version 7 and later      | No compatibility layer. Must specify the correct table. |
|   4   | version 10.2.2 and later | No compatibility layer.                                 |

<Warning>
  The compatibility layer will transform some pre-7 database tables to their current equivalents. **This will affect performance!**
</Warning>

## Case and character set

CRMScript is case sensitive and uses the Unicode character set.

```crmscript theme={null}
String userplan = "Standard";
String Userplan = "Sales";
String userPlan = "Marketing;"
```

These are 3 distinct variables because they have different casing.

CRMScript is commonly written with camel case that starts with a lower-case letter.
Structs and the built-in classes use pascal-case starting with an upper-case letter.

## Keywords

Keywords are words that have special meaning in CRMScript and can't be used to name stuff in your code.
Check the [list of reserved words][10] if in doubt.

## Statements

Instructions are called *statements* and are separated by semicolons (`;`).
Statements that should be executed together as a code block must be enclosed in a pair of curly braces \{}.

Expressions are combinations of values/[variables][1] and [operators][2].

Types of statements:

* [variable][3] declaration
* [assignment][2]
* [struct][4] definition
* [function][5] definition and call
* [for][6] and [while][7] loops
* [conditional statements][8]

## Text and numbers

Text is written within double or single quotes. Numbers are written with or without decimals.

Learn more about [data types][9].

## Comments

Comments are explanatory text that is purposely ignored when the script is run. They are for the humans reading the code.

Comments can also be statements selectively marked to not be executed. For example, you could exclude some failing code while trying to narrow down where you problem is.

* Single-line comments start with double slashes //
* Multi-line comments are wrapped between /\* and \*/

```crmscript! theme={null}
// This is a single-line comment.
Integer i = 5;
/*
This is a multi-line comment with an ignored statement.
i = i * 2;
*/
print(i.toString());
```

[1]: ./variables

[2]: ./operators

[3]: ./variables

[4]: ./structs

[5]: ./functions

[6]: ./for-loops

[7]: ./while-loops

[8]: ./conditions

[9]: ./datatypes-intro

[10]: ./reserved


## Related topics

- [Dot-syntax](/en/automation/crmscript/searchengine/dot-syntax.md)
- [The Dynamic Provider - the dot syntax](/en/api/search/odata/dynamic-provider.md)
- [Organization of repositories](/contribute/files-and-folders.md)
- [How to include code in docs](/contribute/markdown-guide/code-in-docs.md)
- [SuperOffice.WebApi.Data.StructuredAddress](/en/api/reference/webapi/SuperOffice.WebApi.Data.StructuredAddress.md)
- [Markdown guide](/contribute/markdown-guide/index.md)