> For the complete documentation index, see [llms.txt](https://bernatf.gitbook.io/human-lambdas-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bernatf.gitbook.io/human-lambdas-documentation/manual/queues/configuration.md).

# Configuration

A queue's configuration defines its capabilities, layout and properties in the underlying data model. This is done through the New and Edit Queue functionality, which exposes the Queue Builder.

{% hint style="info" %}
Your account needs to have admin-level permissions in order to configure new or existing queues.
{% endhint %}

## Configuring a New Queue

If we do **Home > New Queue**, we navigate to an empty Queue Builder screen, which lets us build a queue from scratch:

![](/files/-MJlVaps1lIhdEEnMeZi)

From here, we can start constructing our queue. A queue is composed by leveraging the components on the left hand-side panel, which we call Blocks. Blocks can be drag-and-dropped into the Queue canvas to create a UI of your preference.

![](/files/-MJlbdLvzYDw-4BkGfbB)

## Anatomy of a Block

Every time you drop a new block into the canvas, the block's settings dialog will pop up, as illustrated above. Each block type will have generic and type-specific parameters.

### Generic parameters

The following settings exist for all types:

* **Label.** Identifies the block towards end users. Shown at the top of the block.
* **Identifier.** The block's identifier, used for technical integrations (*ie* API, Webhooks, CSV...)

These other settings might appear for several, but not all, types:

* **Placeholder.** A sample value used to exemplify how the queue will look like in the builder view.
* **Read-only.** Makes the block's value immutable inside the queue. In these cases the value can only be set once per task when it is created.
* **Required.** Disallows task completion until the block's value is non-empty.
* **Use Placeholder.** Renders the Placeholder as a fallback when no value has been supplied for a particular block in the task.

### Other actions

By hovering over the block, you can see its settings and delete buttons, as well as move and resize handles to adjust each block in the layout:

![](/files/-MYFh6CAiKWhdakm6c1B)

## Block Catalog

Below are all the Block types currently supported in Human Lambdas.

### Text

Displays a string of text.

### Number

Displays numeric data, no reformatting applied.

### Date

Displays a date (represented as an ISO-8601) and a date picker for more convenient date input.

### Image

Displays an image, as long as its underlying value points to a valid static image URL.

### Audio

Plays an audio, as long as its underlying value points to a valid static audio URL.

### Video

Displays a video, as long as its underlying value points to a valid static video URL.

### Binary

Binary question, with Yes/No options, represented as `true` / `false` values.

### Single Selection

Single choice question. Similar to how Blocks work, each option has a Label and Identifier for end users and technical integrations respectively.

### Multiple Selection

Multiple choice question. Similar to how Blocks work, each option has a Label and Identifier for end users and technical integrations respectively.

### Form Sequence

Displays a sequence of questions. The question types supported are:

* Binary
* Single Selection
* Multiple Selection
* Text
* Number
* Email
* Link

The questions will be presented sequentially from top to bottom. There is limited support for logic jumps — useful to build conditional paths — under the following types:

* Binary
* Single Selection

### Email

Displays an email address, and includes validation on input.

### Link

Displays a URL link, and includes validation on input.

### Embed

Displays a website through an iframe.

{% hint style="info" %}
Note that some websites might not work if they are blocking Cross-Origin requests.
{% endhint %}

{% hint style="warning" %}
Make sure to prefix the URL with `https://` otherwise the resource will not load.
{% endhint %}

### PDF

Renders a PDF given a valid .pdf URL. Uses the browser's PDF viewer.

{% hint style="warning" %}
Make sure to prefix the URL with `https://` otherwise the resource will not load.
{% endhint %}

### Text Highlighting

For Named Entity Recognition tasks, it allows the user to annotate segments of a text and map them to various predefined categories.

### Rich Text

A Rich Text editor with support for Markdown and HTML text formatting.

### Bounding Boxes

For Object Detection annotation tasks, it allows the user to draw categorized bounding boxes over an image file, supplied by its URL.

### Text Sequence

Represents a sequence of strings. Useful for cases where the task might require processing an indeterminate number of text items.

### Other Blocks

If you can think of a block that would suit your use case but is not listed above, raise an issue on the GitHub [repo](https://github.com/Human-Lambdas/human-lambdas). Please note though that this project is not being actively maintained.
