Merge branch 'develop' into 'fb-bros-14'

Workflow run: https://github.com/HumanSignal/label-studio/actions/runs/15254104277

Author: Gondragos

docs/source/guide/install_enterprise_k8s.md

@@ -259,7 +259,7 @@ Adjust the included defaults to reflect your environment and copy these into a n
 
 </div>
 
-## Optional: set up TLS for PostgreSQL
+## Optional: Set up TLS for PostgreSQL
 To configure Label Studio Enterprise to use TLS for end-client connections with PostgreSQL, do the following:
 
 1. Enable TLS for your PostgreSQL instance and save Root TLS certificate, client certificate and its key for the next steps.
@@ -286,7 +286,7 @@ global:
 
 4. Install or upgrade Label Studio Enterprise using Helm.
 
-## Optional: set up TLS for Redis
+## Optional: Set up TLS for Redis
 To configure Label Studio Enterprise to use TLS for end-client connections with Redis, do the following:
 
 1. Enable TLS for your Redis instance and save Root TLS certificate, client certificate and its key for the next steps.
@@ -313,6 +313,51 @@ global:
 
 4. Install or upgrade Label Studio Enterprise using Helm.
 
+
+## Optional: Set up username and password for Redis
+
+Use one of these options to set a password and a username for Redis:
+
+**1. Password via Kubernetes Secret**. Use this when:
+* You want to avoid embedding credentials in `values.yaml`
+* You already manage Secrets in your cluster
+* You need a simple auth without multiple Redis users and you don't have username
+
+```yaml
+global:
+  redisConfig:
+    host: "redis://redis.example.com:6379/1"
+    password:
+      secretName: "my-redis-secret"   # Kubernetes Secret name
+      secretKey: "redis-password"      # Key inside Secret
+```
+
+**2. Username + password in URL**. Use this when:
+* Redis v.7 or later, and with ACL-enabled users
+* You need a dedicated Redis user for permission scoping
+* You need a quick, throwaway setup or local testing
+
+```yaml
+global:
+  redisConfig:
+    host: "redis://myuser:mypassword@redis.example.com:6379/1"
+```
+
+ **3. Username in environment variables + password in secret**. Use this when:
+* Redis v.7 or later, and with ACL-enabled users
+* You want to keep the password secret but still specify a username
+
+```yaml
+global:
+  redisConfig:
+    host: "redis://redis.example.com:6379/1"
+    password:
+      secretName: "my-redis-secret"   # Kubernetes Secret name
+      secretKey: "redis-password"      # Key inside Secret
+  extraEnvironmentVars:
+    REDIS_USERNAME: "myuser"           # Injected into pod env
+```
+
 ## Use Helm to install Label Studio Enterprise on your Kubernetes cluster
 
 Use Helm to install Label Studio Enterprise on your Kubernetes cluster. Provide your custom resource definitions YAML file. Specify any environment variables that you need to set for your Label Studio Enterprise installation using the `--set` argument with the `helm install` command.

docs/source/guide/label_studio_compare.md

@@ -160,7 +160,7 @@ Label Studio is available to everyone as open source software (Label Studio Comm
     <td style="text-align:center">✅</td>
   </tr>
   <tr>
-    <td><b>Bulk labeling</b><br/><a href="https://docs.humansignal.com/guide/labeling#Bulk-labeling">Classify data in batches.</a></td>
+    <td><b>Bulk labeling</b><br/><a href="https://docs.humansignal.com/guide/labeling_bulk">Classify data in batches.</a></td>
     <td style="text-align:center">❌</td>
     <td style="text-align:center">❌</td>
     <td style="text-align:center">✅</td>

docs/source/guide/labeling.md

@@ -131,75 +131,6 @@ To label tasks multiple times while the minimum annotations required is set to o
 4. Click **Submit** to save your annotation.
 5. Click the next task in the data manager to open the quick labeling view for that task and repeat steps 2-4.
 
-<div class="enterprise-only">
-
-## Bulk labeling
-
-Bulk labeling is useful when you have a large set of tasks that share a common label or annotation that you want to apply in one go. For example:
-
-* **Data classification**: Quickly label multiple tasks with the same category. 
-* **Filtering and grouping**: Use filters to isolate tasks matching specific criteria (e.g., tasks you know are all “Approved”), then label them in bulk. 
-* **Speed and consistency**: Avoid repetitive labeling for items that can confidently share a label.
-
-#### Supported data types
-
-Bulk labeling supports all data types (e.g. images, text, audio, video). 
-
-#### Supported labeling tasks
-
-Bulk labeling supports classification tasks and text area input. 
-
-You can use any combination of supported control tags, and all object tags (e.g. `<Image>`, `<Text>`, `<Video`) are supported. 
-
-The following control tags can be assigned through the bulk labeling action:
-
-* [Choices](/tags/choices.html)
-* [DateTime](/tags/datetime.html)
-* [Number](/tags/number.html)
-* [Rating](/tags/rating.html)
-* [Taxonomy](/tags/taxonomy.html)
-* [TextArea](/tags/textarea.html)
-
-If your labeling configuration includes control tags not listed above, the **Bulk labeling** action is not accessible. 
- 
-
-!!! note Limitations
-    Note the following:
-    * At this time, only global classification tasks are supported. This means that the control tag cannot have `perItem` or `perRegion` enabled. 
-    * Lead time is not calculated for annotations performed through the bulk labeling option. 
-
-#### Bulk labeling panel 
-
-When you perform bulk labeling, your options open in a side panel. Note that you can expand or collapse this panel as necessary by clicking the expand/collapse icons or by pressing `shift` + `.`.
-
-![Gif opening and closing bulk label drawer](/images/label/bulk-expand.gif)
-
-### List view
-
-You can perform bulk labeling from the list view in the Data Manager. This is especially useful if you want to use filters to label a subset of results. 
-
-Select the checkboxes next to the tasks you want to annotate and then click the drop-down menu next to **Label *n* Tasks**. Select **Bulk label**. This opens a panel with your labeling options (see [above](#Bulk-labeling-panel)).  
-
-![Screenshot of Bulk label option from List view](/images/label/bulk-list-view.png)
-
-Make your selections and click **Submit**, 
-
-### Grid view
-
-You can use the grid view to visually inspect and then select tasks for bulk annotation. 
-
-To select tasks from the grid view, you can click the checkboxes next to them or open each and select tasks as you navigate through them. 
-
-![Gif showing selecting images in grid view](/images/label/bulk-grid-navigating.gif)
-
-Once selected, click the drop-down menu next to **Label *n* Tasks**. Select **Bulk label**. This opens a panel with your labeling options (see [above](#Bulk-labeling-panel)).
-
-!!! info Tip
-    There are hotkeys for selecting the task, scrolling, zooming, and navigating between tasks. To see a list of the available hotkeys, click the help icon above the task:
-
-    ![Screenshot highlighting help icon](/images/label/bulk-hotkeys.png)
-
-</div>
 
 ## Perform ML-assisted labeling with interactive preannotations
 

docs/source/guide/labeling_bulk.md

@@ -0,0 +1,85 @@
+---
+title: Bulk labeling
+short: Bulk labeling
+tier: enterprise
+type: guide
+order: 0
+order_enterprise: 135
+meta_title: Bulk Labeling
+meta_description: Bulk labeling in Label Studio
+section: "Create & Manage Projects"
+parent: "labeling"
+parent_enterprise: "labeling"
+date: 2025-05-24 17:19:21
+---
+
+Bulk labeling is useful when you have a large set of tasks that share a common label or annotation that you want to apply in one go. For example:
+
+* **Data classification**: Quickly label multiple tasks with the same category. 
+* **Filtering and grouping**: Use filters to isolate tasks matching specific criteria (e.g., tasks you know are all “Approved”), then label them in bulk. 
+* **Speed and consistency**: Avoid repetitive labeling for items that can confidently share a label.
+
+## Supported data types
+
+Bulk labeling supports all data types (e.g. images, text, audio, video). 
+
+## Supported user roles
+
+Only users who are in the Reviewer, Manager, Admin, or Owner role can use the bulk labeling actions available from the Data Manager. 
+
+!!! info Tip
+    Users in the Annotator role can still use [plugin-enabled bulk labeling actions](/plugins/bulk_labeling). 
+
+## Supported labeling tasks
+
+Bulk labeling supports classification tasks and text area input. 
+
+You can use any combination of supported control tags, and all object tags (e.g. `<Image>`, `<Text>`, `<Video`) are supported. 
+
+The following control tags can be assigned through the bulk labeling action:
+
+* [Choices](/tags/choices.html)
+* [DateTime](/tags/datetime.html)
+* [Number](/tags/number.html)
+* [Rating](/tags/rating.html)
+* [Taxonomy](/tags/taxonomy.html)
+* [TextArea](/tags/textarea.html)
+
+If your labeling configuration includes control tags not listed above, the **Bulk labeling** action is not accessible. 
+ 
+
+!!! note Limitations
+    Note the following:
+    * At this time, only global classification tasks are supported. This means that the control tag cannot have `perItem` or `perRegion` enabled. 
+    * Lead time is not calculated for annotations performed through the bulk labeling option. 
+
+## Bulk labeling panel 
+
+When you perform bulk labeling, your options open in a side panel. Note that you can expand or collapse this panel as necessary by clicking the expand/collapse icons or by pressing `shift` + `.`.
+
+![Gif opening and closing bulk label drawer](/images/label/bulk-expand.gif)
+
+## List view
+
+You can perform bulk labeling from the list view in the Data Manager. This is especially useful if you want to use filters to label a subset of results. 
+
+Select the checkboxes next to the tasks you want to annotate and then click the drop-down menu next to **Label *n* Tasks**. Select **Bulk label**. This opens a panel with your labeling options (see [above](#Bulk-labeling-panel)).  
+
+![Screenshot of Bulk label option from List view](/images/label/bulk-list-view.png)
+
+Make your selections and click **Submit**, 
+
+## Grid view
+
+You can use the grid view to visually inspect and then select tasks for bulk annotation. 
+
+To select tasks from the grid view, you can click the checkboxes next to them or open each and select tasks as you navigate through them. 
+
+![Gif showing selecting images in grid view](/images/label/bulk-grid-navigating.gif)
+
+Once selected, click the drop-down menu next to **Label *n* Tasks**. Select **Bulk label**. This opens a panel with your labeling options (see [above](#Bulk-labeling-panel)).
+
+!!! info Tip
+    There are hotkeys for selecting the task, scrolling, zooming, and navigating between tasks. To see a list of the available hotkeys, click the help icon above the task:
+
+    ![Screenshot highlighting help icon](/images/label/bulk-hotkeys.png)

docs/source/guide/release_notes/onprem/2.21.0.md

@@ -19,7 +19,7 @@ There is a new **Bulk label** action available from the Data Manager. You can us
 
 This feature also includes enhancements to the Grid View in the Data Manager. Now when viewing images, you can zoom in/out, scroll, and pan.
 
-For more information, see the [Bulk labeling documentation](labeling#Bulk-labeling) and [Bulk Labeling: How to Classify in Batches](https://humansignal.com/blog/bulk-labeling-how-to-classify-in-batches/).
+For more information, see the [Bulk labeling documentation](labeling_bulk) and [Bulk Labeling: How to Classify in Batches](https://humansignal.com/blog/bulk-labeling-how-to-classify-in-batches/).
 
 ![Screenshot of bulk label action](/images/releases/2-21-bulk-label.png)
 

docs/source/guide/release_notes/onprem/2.24.0.md

@@ -22,6 +22,9 @@ Click your avatar in the upper right to find the toggle for dark mode.
 - **Light** - Use light mode.
 - **Dark** - Use dark mode.
 
+!!! note
+    Dark mode is not available for environments that use white labeling. 
+
 ![Screenshot of dark mode](/images/releases/2-24-dark-mode.png)
 
 ![Animated gif of dark mode](/images/releases/2-24-darkmode.gif)

docs/source/guide/storage.md

@@ -24,7 +24,9 @@ Set up the following cloud and other storage systems with Label Studio:
 
 When working with an external cloud storage connection, keep the following in mind:
 
-* Label Studio doesn't import the data stored in the bucket, but instead creates *references* to the objects. Therefore, you must have full access control on the data to be synced and shown on the labeling screen.
+* For Source storage:
+   * When "Treat every bucket object as a source file" is checked, Label Studio doesn’t import the data stored in the bucket, but instead creates *references* to the objects. Therefore, you have full access control on the data to be synced and shown on the labeling screen.
+   * When "Treat every bucket object as a source file" is unchecked, bucket files are assumed to be immutable; the only way to push an updated file's state to Label Studio is to upload it with a new filename or delete all tasks that are associated with that file and resync.
 * Sync operations with external buckets only goes one way. It either creates tasks from objects on the bucket (Source storage) or pushes annotations to the output bucket (Target storage). Changing something on the bucket side doesn't guarantee consistency in results.
 * We recommend using a separate bucket folder for each Label Studio project. 
 * Storage Regions: To minimize latency and improve efficiency, store data in cloud storage buckets that are geographically closer to your team rather than near the Label Studio server.
@@ -75,7 +77,7 @@ Label Studio Source Storages feature an option called "Treat every bucket object
 
 ###### Off
 
-When disabled, tasks in JSON format can be loaded directly from storage buckets into Label Studio. This approach is particularly helpful when dealing with complex tasks that involve multiple media sources.
+When disabled, tasks in JSON or JSONL/NDJSON format can be loaded directly from storage buckets into Label Studio. This approach is particularly helpful when dealing with complex tasks that involve multiple media sources.
 
 <img src="/images/source-storages-treat-off.png" class="make-intense-zoom">
 
@@ -174,6 +176,18 @@ Or:
 
 <br>
 
+{% details <b>Example with JSONL</b> %}
+
+`tasks.jsonl`
+```
+{ "image": "s3://bucket/1.jpg", "text": "opossums are awesome" }
+{ "image": "s3://bucket/2.jpg", "text": "cats are awesome" }
+```
+
+{% enddetails %}
+
+<br>
+
 ###### On
 
 When enabled, Label Studio automatically lists files from the storage bucket and constructs tasks. This is only possible for simple labeling tasks that involve a single media source (such as an image, text, etc.).* 

docs/source/guide/tasks.md

@@ -52,9 +52,11 @@ You can import many types of data, including text, timeseries, audio, and image
 | Structured data | .csv, .tsv | 
 | [Text](#Plain-text) | .txt, .json |
 | [Time series](#Import-CSV-or-TSV-data) | .csv, .tsv, .json |
-| [Tasks with multiple data types](#Basic-Label-Studio-JSON-format) | .csv, .tsv, .json |
+| [Tasks with multiple data types](#Basic-Label-Studio-JSON-format) | .csv, .tsv, .json, .jsonl* |
 | Video | .mp4, .webm |
 
+\* *Cloud storage only*
+
 If you don't see a supported data or file type that you want to import, please let us know by submitting an issue to the <a className="no-go" href="https://github.com/humansignal/label-studio/issues">Label Studio Repository</a>.
 
 
@@ -347,6 +349,8 @@ You can then import text tasks to label that match the following JSON format:
 #### Example JSON with multiple tasks
 You can place multiple tasks in one JSON file if you're uploading the JSON file using Label Studio Import Dialog only (Data Manager => Import button), or when importing from [cloud storage](storage.html). When using cloud storage, you must ensure every task in the file is formatted the same way. 
 
+If you're using [Source cloud storage](storage.html), you can also place multiple tasks in a newline-delimited JSON file (JSONL/NDJSON).
+
 <br/>
 {% details <b>To place multiple tasks in one JSON file, use this JSON format example</b> %}
 This example contains multiple text classification tasks with no annotations or predictions.

docs/source/guide/troubleshooting.md

@@ -112,7 +112,9 @@ Label Studio does not support labeling PDF files directly. However, you can conv
 
 When working with an external Cloud Storage connection (S3, GCS, Azure), keep the following in mind:
 
-* Label Studio doesn’t import the data stored in the bucket, but instead creates *references* to the objects. Therefore, you have full access control on the data to be synced and shown on the labeling screen.
+* For Source storage:
+   * When "Treat every bucket object as a source file" is checked, Label Studio doesn’t import the data stored in the bucket, but instead creates *references* to the objects. Therefore, you have full access control on the data to be synced and shown on the labeling screen.
+   * When "Treat every bucket object as a source file" is unchecked, bucket files are assumed to be immutable; the only way to push an updated file's state to Label Studio is to upload it with a new filename or delete all tasks that are associated with that file and resync.
 * Sync operations with external buckets only goes one way. It either creates tasks from objects on the bucket (Source storage) or pushes annotations to the output bucket (Target storage). Changing something on the bucket side doesn’t guarantee consistency in results.
 * We recommend using a separate bucket folder for each Label Studio project.