# Packages

**Packages** are blocks and palettes created by the User using the "Package Manager" tool in Sherpa Designer. Packages can be exchanged through files (the "Local Packages" tab) or through the Orchestrator (the "Remote Packages" tab). Developers can create their own block palettes and use similar palettes from other developers by agreement. The exchange capability is implemented through the exchange using the "Package Manager." This same tool allows for receiving updates on palettes and conducting version updates for blocks.

The "Packages" screen has a structure similar to the "Processes" screen: "Package" and "Package Versions." To display a list of versions in the "Package Versions" table, select the desired package from the "Packages" list. By default, one of the versions is the current one. It is displayed in the "Current Version" column of the "Projects" table. In the "Package Versions" table, the current version is highlighted in blue when selecting a Process in the "Packages" table.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-89fa8e83df9151e79a024c171e515ee57fcf9ecc%2Fimage%20(193).png?alt=media" alt=""><figcaption></figcaption></figure>

## **Creating a New Package**

To create a new Package in the "Packages" table, you need to click the "Create" button and fill out the opened form:

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-393d1861be0f91855f85084c51ea6b7161100dae%2Fimage%20(194).png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="54"></th><th width="246"></th><th></th></tr></thead><tbody><tr><td><strong>No.</strong></td><td><strong>Interface Element</strong></td><td><strong>Description</strong></td></tr><tr><td>1.</td><td>text field "Name"</td><td>Name of the Package. This field is required.</td></tr><tr><td>2.</td><td>text field "Run on Sherpa RPA Runtime version no lower than"</td><td>Allows specifying the version number of Sherpa RPA Runtime below which the Package will not run.</td></tr><tr><td>3.</td><td>text field "Description"</td><td>Description of the Package.</td></tr><tr><td>4.</td><td>text field "Access Folder"</td><td>Allows specifying the Access Folder for the created Package.</td></tr></tbody></table>

To save the created Package, after filling out the form, you need to click the "OK" button. The newly created item - Package - will appear in the list. The newly created Package has no versions:

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-6c57cc12a27225151f816d8b4f0d647527c913c1%2Fimage%20(195).png?alt=media" alt=""><figcaption></figcaption></figure>

## **Creating a New Version of the Package**

To create a new version of the Package, you need to select the Package in the "Packages" table for which a new version will be created. If the package is not selected, the Orchestrator will show a warning message:

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-3cc7177049b0c276d5299bc3b64961926404ca8a%2Fimage%20(196).png?alt=media" alt=""><figcaption></figcaption></figure>

Next, in the "Package Versions" table, you need to click the "Create" button and fill out the fields in the opened form:

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-0e0a0d3c8cdda38aba730fdd84e4aa49960b301d%2Fimage%20(197).png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="57"></th><th width="206"></th><th></th></tr></thead><tbody><tr><td><strong>No.</strong></td><td><strong>Interface Element</strong></td><td><strong>Description</strong></td></tr><tr><td>1.</td><td>text field "Name"</td><td><p>Name of the Package version. This field is required.</p><p>Note: By default, the "Name" field is populated with the Package name, the current date, and the time of version creation. These can be changed to a relevant title.</p></td></tr><tr><td>2.</td><td>text field "Description"</td><td>Description of the Package version. In this field, you can specify, for example, changes in the new version.</td></tr><tr><td>3.</td><td>button "Select Package File"</td><td>Selects the Package file (with the .robot extension). Without a file, the version will not be saved.</td></tr></tbody></table>

When you click the "Select Package File" button, a window will open on your computer to select the Package file. Multiple versions of each Package can be created.

## **Editing a Previously Created Package**

To view and edit the properties of a specific Package, you need to select it from the list and click on the icon ![](https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-eb671091e329aad58e1a028d9a4a16105a449481%2Fimage%20\(198\).png?alt=media). After that, a form with the settings of the selected Package will open, where you can make the necessary changes. In addition to the fields filled out when creating the Package, the form will show the GUID (unique identifier assigned to the Package after its creation). This field cannot be edited.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-e4b39509982a8a1ca01804d580f4f92765f443ae%2Fimage%20(200).png?alt=media" alt=""><figcaption></figcaption></figure>

## **Editing a Previously Created Version of the Package**

To view and edit the properties of a specific version of the Package, you need to select it from the list and click on the icon ![](https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-c896ddd3b4a74e8561a716a7ef28ca5c7164505d%2F2025-04-17_22-35-51.png?alt=media). After that, a form with the settings of the selected version of the Package will open, where you can make the necessary changes. In addition to the fields filled out when creating the Package version, the form will show the GUID (unique identifier assigned to the Package version after its creation). This field cannot be edited.

<figure><img src="https://3237142148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FscP4BXwl9ufpJr5mfVln%2Fuploads%2Fgit-blob-f22e4342a953f272650db58ed708d8eaf11484bd%2Fimage%20(199).png?alt=media" alt=""><figcaption></figcaption></figure>

In Sherpa Designer, you can create your own blocks through the editor and combine them into palettes. This functionality is described [here](https://docs.sherparpa.ru/en/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/glavnaya-panel/bloki/redaktor-blokov).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/en/sherpa-rpa/sherpa-orchestrator/rabota-v-sherpa-orchestrator/ekrany/pakety.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
