> For the complete documentation index, see [llms.txt](https://socrates.gitbook.io/socrates/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://socrates.gitbook.io/socrates/fundamentals/projects.md).

# Blocks

A Block is a component made of a Code in a specific Language. It might have [parameters](/socrates/fundamentals/parameters.md) (available as ENV variables to the code), defaults, and a Pre-Code in `Shell` to execute before the main. It may also be directly attached to a file in [Github](/socrates/configuration/settings/github.md). 

* Any files created during execution will be saved as [Artifacts](/socrates/fundamentals/instances/artifacts.md).
* Outputs can be set by printing following syntax: `::set-output key=value`.

## Creating a Block

Go to `/block/create/`

#### Fill in Basic Details

![Fill In the Details](https://1971768033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVaIfG2Rerp9OfcB9UQTT%2Fuploads%2FzSjz9q7CKwCBsdr79UZO%2FScreen%20Shot%202022-04-03%20at%2016.21.20.png?alt=media\&token=146bb3bf-6cbf-482d-9830-7bdb4a4883a6)

#### Fill your Block's Parameters

![Parameters](https://1971768033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVaIfG2Rerp9OfcB9UQTT%2Fuploads%2FpwBBEuNuZSlGdyRBQBfT%2FScreen%20Shot%202022-04-03%20at%2016.23.08.png?alt=media\&token=a0671069-edbe-4526-9f3d-ba444c5dc979)

#### Write your Code or Choose from Github

{% hint style="warning" %}
If choosing a Github file, you won't be able to change and save the code. Your Block will always match what's in Github. In order to write custom code, copy the file's code and disconnect from Github. Then you will be able to edit.
{% endhint %}

![](https://1971768033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVaIfG2Rerp9OfcB9UQTT%2Fuploads%2Fm9SATGtHCrMtljbfwzfj%2FScreen%20Shot%202022-04-03%20at%2016.25.08.png?alt=media\&token=139c2651-bfaf-4d81-925e-c6ac245e065f)

#### Review and Create

![](https://1971768033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVaIfG2Rerp9OfcB9UQTT%2Fuploads%2Fi5IpvtuTsmiJYz5GmTEH%2FScreen%20Shot%202022-04-03%20at%2016.27.50.png?alt=media\&token=fb90f863-4f04-40a8-93d4-73f010399a94)