From 8554faec8c43c931189e17fe70f943b0397f96f0 Mon Sep 17 00:00:00 2001
From: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
Date: Tue, 12 Nov 2024 08:27:17 +1100
Subject: [PATCH] [8.x] [Docs] Add section for assigning colors to terms
 (#199241) (#199714)

# Backport

This will backport the following commits from `main` to `8.x`:
- [[Docs] Add section for assigning colors to terms
(#199241)](https://github.com/elastic/kibana/pull/199241)

<!--- Backport version: 9.4.3 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT
[{"author":{"name":"wajihaparvez","email":"wajiha.parvez@elastic.co"},"sourceCommit":{"committedDate":"2024-11-11T20:59:39Z","message":"[Docs]
Add section for assigning colors to terms (#199241)\n\n##
Summary\r\n\r\nAdded a section with instructions for assigning colors to
terms in a\r\ntable. The technical preview warning will be removed in
GA.\r\n\r\nRel: https://github.com/elastic/kibana/pull/189895\r\nCloses:
[#559](https://github.com/elastic/platform-docs-team/issues/559)\r\n\r\n---------\r\n\r\nCo-authored-by:
florent-leborgne
<florent.leborgne@elastic.co>","sha":"b781c4eec4381ac5ff6bb695d42afb8c971ed70b","branchLabelMapping":{"^v9.0.0$":"main","^v8.17.0$":"8.x","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","v9.0.0","v8.16.0","backport:version","v8.17.0"],"title":"[Docs]
Add section for assigning colors to
terms","number":199241,"url":"https://github.com/elastic/kibana/pull/199241","mergeCommit":{"message":"[Docs]
Add section for assigning colors to terms (#199241)\n\n##
Summary\r\n\r\nAdded a section with instructions for assigning colors to
terms in a\r\ntable. The technical preview warning will be removed in
GA.\r\n\r\nRel: https://github.com/elastic/kibana/pull/189895\r\nCloses:
[#559](https://github.com/elastic/platform-docs-team/issues/559)\r\n\r\n---------\r\n\r\nCo-authored-by:
florent-leborgne
<florent.leborgne@elastic.co>","sha":"b781c4eec4381ac5ff6bb695d42afb8c971ed70b"}},"sourceBranch":"main","suggestedTargetBranches":["8.16","8.x"],"targetPullRequestStates":[{"branch":"main","label":"v9.0.0","branchLabelMappingKey":"^v9.0.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/199241","number":199241,"mergeCommit":{"message":"[Docs]
Add section for assigning colors to terms (#199241)\n\n##
Summary\r\n\r\nAdded a section with instructions for assigning colors to
terms in a\r\ntable. The technical preview warning will be removed in
GA.\r\n\r\nRel: https://github.com/elastic/kibana/pull/189895\r\nCloses:
[#559](https://github.com/elastic/platform-docs-team/issues/559)\r\n\r\n---------\r\n\r\nCo-authored-by:
florent-leborgne
<florent.leborgne@elastic.co>","sha":"b781c4eec4381ac5ff6bb695d42afb8c971ed70b"}},{"branch":"8.16","label":"v8.16.0","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.x","label":"v8.17.0","branchLabelMappingKey":"^v8.17.0$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

Co-authored-by: wajihaparvez <wajiha.parvez@elastic.co>
---
 docs/user/dashboard/lens.asciidoc | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/docs/user/dashboard/lens.asciidoc b/docs/user/dashboard/lens.asciidoc
index 8623b8c3ca107..3c2a120d167d9 100644
--- a/docs/user/dashboard/lens.asciidoc
+++ b/docs/user/dashboard/lens.asciidoc
@@ -96,13 +96,37 @@ All columns that belong to the same layer pane group are sorted in the table.
 
 * *Text alignment* &mdash; Aligns the values in the cell to the *Left*, *Center*, or *Right*.
 
+* *Color by value* &mdash; Applies color to the cell or text values. To change the color, click the *Edit colors* icon. 
+
 * *Hide column* &mdash; Hides the column for the field.
 
 * *Directly filter on click* &mdash; Turns column values into clickable links that allow you to filter or drill down into the data.
 
 * *Summary row* &mdash; Adds a row that displays the summary value. When specified, allows you to enter a *Summary label*.
 
-* *Color by value* &mdash; Applies color to the cell or text values. To change the color, click *Edit*. 
+[float]
+[[assign-colors-to-terms]]
+===== Assign colors to terms
+
+preview::[]
+
+For term-based metrics, assign a color to each term with color mapping. 
+
+. Create a custom table.
+ 
+. In the layer pane, select a *Rows* or *Metrics* field. 
+
+. In the *Color by value* option, select *Cell* or *Text*.
+
+. Click the *Edit colors* icon.
+
+. Toggle the button to use the Color Mapping feature.
+
+. Select a color palette and mode.
+
+. Click *Add assignment* to assign a color to a specific term, or click *Add all unassigned terms* to assign colors to all terms. Assigning colors to dates is unsupported.
+
+. Configure color assignments. You can also select whether unassigned terms should be mapped to the selected color palette or a single color. 
 
 [float]
 [[drag-and-drop-keyboard-navigation]]