𝐀𝐑𝐑𝐀𝐘 From Values Generator - Array — GTM Variable Template for GTM

VARIABLES › GTM

𝐀𝐑𝐑𝐀𝐘 From Values Generator - Array CORE GTM

Direct (.tpl)

Generates an array from a simple GTM table of values.

---

When to Use This

GTM Utilities

Access GTM-specific APIs: dataLayer, debug mode, container settings.

Type Conversion

Safely convert between data types — strings, numbers, booleans, arrays, objects.

Extraction

Pull specific values, segments, or patterns from complex data structures.

---

Examples

Array from table values▶ Try

INPUT

Array Values: [

OUTPUT

['apple', 'banana', 'cherry']

Empty table returns empty▶ Try

INPUT

Array Values: []

OUTPUT

[]

---

GTM Configuration

This is what you'll see when you open this variable in Google Tag Manager. Hover the icons for details.

𝐀𝐑𝐑𝐀𝐘 From Values Generator - Array

Read-Only Try Live

ARRAY ⬇

Array Values

💾 Define the values to include in the array.

Each row will become an element in the resulting array. Empty values and variables are preserved.

⊖

Add Row

Value Processing

Mapper Function (optional)

⚙️ Optional function to transform each individual value before adding it to the array: val => transformedVal

Use this for:
  • Split strings: val => val.split(',')
  • Trim whitespace: val => val.trim()
  • Parse numbers: val => parseFloat(val)
  • Transform case: val => val.toUpperCase()

Note: This applies to each value individually, before creating the final array.

Result Handling

Output Function (optional)

⚙️ Optional function to transform the entire array before returning it: arr => transformedArr

Use this for:
  • Filter array: arr => arr.filter(x => x)
  • Flatten nested arrays: arr => arr.flat()
  • Convert to string: arr => arr.join(',')
  • Sort array: arr => arr.sort()

Note: This applies to the complete array after all values have been processed.

Array Values list

✕

+ Add Row

🔗 Result Handling — Chain Variables

Chain apply-mode variables to the output. Each variable receives the result of the previous one.

getType()

+ Chain another variable

---

Related Variables

Same category: GTM

→ document.title → estimateReadingTime → gaEcommerceEventList → gaLeadGenerationEventList → getCookieValue → getDataLayerByEvent → getDataLayerCurrent → getDataLayerValue → getGaMeasurementIds → getLocalStorage → getRootDomain! → gtmIsDebugMode → gtmIsPreviewMode → hasLocalStorageKey → isGrantedAdPersonalization → isGrantedAdStorage → isGrantedAdUserData → isGrantedAnalyticsStorage → isGrantedFunctionalityStorage → isGrantedPersonalizationStorage → isGrantedSecurityStorage → 𝐀𝐑𝐑𝐀𝐘 From Indexed Values Generator - Array → 𝐂𝐎𝐌𝐌𝐀𝐍𝐃 𝐓𝐀𝐁𝐋𝐄 Lazy Generator (Advanced) - Object → 𝐎𝐁𝐉𝐄𝐂𝐓 From Arrays Generator - Object → 𝐎𝐁𝐉𝐄𝐂𝐓 Smart Generator - Object → 𝐎𝐁𝐉𝐄𝐂𝐓 Transformer Generator (Advanced) - Object

---

Under the Hood

📜 View Implementation Code

/**
 * Creates an array from a simple table by extracting and optionally transforming values from the 'val' column.
 * 
 * @param {Array<Object>} data.tbl - The array of objects representing the simple table.
 * @param {Function} [data.map] - Optional function to transform each value before adding to array.
 * @param {Function|string} [data.out] - Optional output handler.
 * 
 * @returns {Array} An array of values extracted from the 'val' column.
 *
 * @framework ggLowCodeGTMKit
 */
const getType = require('getType');

const simpleTable = getType(data.tbl) === 'array' && data.tbl || [];
const safeFunction = fn => typeof fn === 'function' ? fn : x => x;
const mapper = safeFunction(data.map);

const result = [];

for (let i = 0; i < simpleTable.length; i++) {
    const item = simpleTable[i];
    if (item) {
        result.push(mapper(item.val));
    }
}

const out = safeFunction(data.out);

return out(result);

🧪 View Test Scenarios (10 tests)

✅ '[example] Array from table values'
✅ '[example] Empty table returns empty'
✅ Table with undefined and empty values - should preserve them
✅ Table with null items - should skip null items
✅ Mapper function to transform each value - should apply to all values
✅ Mapper with split function - should split each string into array
✅ Output function to filter array - should remove empty values
✅ Output function to join array - should convert to CSV string
✅ Combination of mapper and output - should apply mapper first then output
✅ Different value types - should preserve types