diff --git a/docs/Selectors/Element attribute selector.md b/docs/Selectors/Element attribute selector.md
index a82260c..02a9672 100644
--- a/docs/Selectors/Element attribute selector.md
+++ b/docs/Selectors/Element attribute selector.md
@@ -4,14 +4,26 @@ For example you could use this selector to extract title attribute from
this link: `link`.
## Configuration options
- * selector - [CSS selector] [css-selector] for the element.
- * multiple - multiple records are being extracted.
+ * selector - [CSS selector] [css-selector] for the element. * multiple type - The way multiple extracted images should be handled.
+ * column count - the number of columns returned when multiple type is set to
+ `Multiple Records in Multiple Columns`
* attribute name - the attribute that is going to be extracted. For example
`title`, `data-id`.
## Use cases
See [Text selector] [text-selector] use cases.
+### Multiple Type
+
+A specific selector can find multiple items on a single site. To handle this a `Multiple Type`
+is available when creating the selector. The selected type affects
+how data is returned
+
+* `First Record Only` - returns only the first record extracted. Use when only one record expected
+* `Multiple Records in Multiple Columns` - returns multiple records split into up to `Column Count`
+ columns. Enables and Requires filling `Column count` (defaults to 5)
+* `Multiple Records in One Column` - returns all extracted records in a single column joined by newline
+
## Related videos
* [How to extract data from element attribute]
diff --git a/docs/Selectors/Image selector.md b/docs/Selectors/Image selector.md
index 73fed3c..a7be647 100644
--- a/docs/Selectors/Image selector.md
+++ b/docs/Selectors/Image selector.md
@@ -7,8 +7,9 @@ report it as a bug.
## Configuration options
* selector - [CSS selector] [css-selector] for the image element.
- * multiple - multiple records are being extracted. Usually should not be
- checked for Image selector.
+ * multiple type - The way multiple extracted images should be handled.
+ * column count - the number of columns returned when multiple type is set to
+ `Multiple Records in Multiple Columns`
## Use cases
See [Text selector] [text-selector] use cases.
@@ -51,6 +52,17 @@ required in order for script to work. Images are renamed to
![Fig. 2: macOS image download][osx-image-download-script]
+### Multiple Type
+
+A specific selector can find multiple items on a single site. To handle this a `Multiple Type`
+is available when creating the selector. The selected type affects
+how data is returned
+
+* `First Record Only` - returns only the first record extracted. Use when only one image expected
+* `Multiple Records in Multiple Columns` - returns multiple records split into up to `Column Count` columns.
+ Enables and Requires filling `Column count` (defaults to 5)
+* `Multiple Records in One Column` - returns all extracted records in a single column joined by newline
+
[text-selector]: Text%20selector.md
[css-selector]: ../CSS%20selector.md
[windows-image-download-script]: ../images/selectors/image/win-image-downloader.gif?raw=true
diff --git a/docs/Selectors/Text selector.md b/docs/Selectors/Text selector.md
index 2c30162..e36e48f 100644
--- a/docs/Selectors/Text selector.md
+++ b/docs/Selectors/Text selector.md
@@ -11,9 +11,11 @@ resulting data.
* selector - [CSS selector] [css-selector] for the element from which data
will be extracted.
- * multiple - multiple records are being extracted. Usually should not be
+ * multiple type - multiple records are being extracted. Usually should not be
checked. If you want to use multiple text selectors within one page with
multiple checked then you might actually need
+ * column count - the number of columns returned when multiple type is set to
+ `Multiple Records in Multiple Columns`
[Element selector] [element-selector].
## Use cases
@@ -43,11 +45,23 @@ element.
For example you want to extract comments for an article. There are multiple
comments in a single page and you only need the comment text (If you would need
other comment attributes then see the example above). You can use
-*Text selector* to extract these comments. The *Text selectors* multiple
-attribute should be checked because you will be extracting multiple records.
+*Text selector* to extract these comments. The preferred *Text selectors* multiple type
+should be selected to enable extracting multiple elements
![Fig. 3: Text selector selects multiple comments][text-selector-multiple-per-page]
+### Multiple Type
+
+A specific selector can find multiple items on a single site. To handle this a `Multiple Type`
+is available when creating the selector. The selected type affects
+how data is returned
+
+* `First Record Only` - returns only the first record extracted. Use when only one record expected
+* `Multiple Records in Multiple Columns` - returns multiple records split into up to `Column Count`
+ columns. Enables and Requires filling `Column count` (defaults to 5)
+* `Multiple Records in One Column` - returns all extracted records in a single column joined by
+ 2 newlines (replaces mulitple newlines in extracted text with one)
+
## Related videos
* [How to scrape multiple items within a listings page]