> For the complete documentation index, see [llms.txt](https://docs.opencutlist.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencutlist.org/features/parts/formulas.md).

# Formulas

Formulas allow you to greatly customize output data.

## The power of Ruby

When a formula field is available, OpenCutList gives you access to a list of variables where you can play with their data by writing [Ruby](https://www.ruby-lang.org/fr/documentation/) code.

Each variable as a [Data Type](/features/parts/formulas/data-types.md) that allows you to access some properties and functions.

## Formula field

The formula field is a text form field where you can write Ruby code. To display the list of available first  level variables, type the **@** character. The list of variables may differ from form to form.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FiXyZVfVszDUeUyd5N0R8%2FCapture%20d%E2%80%99e%CC%81cran%202025-07-24%20a%CC%80%2018.34.42.png?alt=media&amp;token=245f3a4e-d36a-4471-b0bb-86f36c17ce80" alt=""><figcaption></figcaption></figure>

With formulas you can perform various things, from concatenate or decorate texts (string) ...

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FQ2xHUWon52HBcxfrsN1a%2FCapture%20d%E2%80%99e%CC%81cran%202025-07-24%20a%CC%80%2018.40.52.png?alt=media&amp;token=2ecd4e0e-2eec-4bf9-946b-508bd4efc4e0" alt=""><figcaption></figcaption></figure>

... to more complex operations with conditional structures.

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FZPTERX7N3hqrcC3QSP0f%2FCapture%20d%E2%80%99e%CC%81cran%202025-07-24%20a%CC%80%2018.40.41.png?alt=media&amp;token=6e6f6ee0-e795-42fd-8667-28d46d10af1a" alt=""><figcaption></figcaption></figure>
