toKebabCase — GTM Variable Template for String

VARIABLES › STRING

toKebabCase CORE String

Direct (.tpl) Apply (.tpl) Add to GTM

Converts a string to kebab-case format. Returns undefined if the input is not a valid string.

---

When to Use This

String Manipulation

Transform, clean, and normalize text data for consistent downstream processing.

Type Conversion

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

Formatting

Normalize casing, spacing, encoding, and presentation of data values.

---

Examples

Spaces to kebab-case▶ Try

INPUT

String To Convert: hello world test

OUTPUT

hello-world-test

Underscores to kebab-case▶ Try

INPUT

String To Convert: hello_world_test

OUTPUT

hello-world-test

Non-string input returns undefined▶ Try

INPUT

String To Convert: 12345

OUTPUT

undefined

---

Live Sandbox

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

toKebabCase

Read-Only Try Live

String To Convert

💾 The string to convert to kebab-case format.

Supported formats:
  ✓ String

Input Setup

Input Function (optional)

⚙️ Optional pre-processing function applied to the input before internal logic (e.g., normalize case, clean string). Internal transformations such as kebab-case conversion will still apply afterward.

Result Handling

Output Function (optional)

⚙️ Optional function to apply to the result before returning it (e.g., str => str + '-suffix', val => val.replace(/^-/, '') to remove leading hyphens). Useful for chaining transformations on the output.

String To Convert string

💡 Type any text to see the result update live

🎯 Using special value — click input to type instead

Test with:

Falsy undefined null "" empty 0 false NaN

Truthy true 42 "hello" {} empty [] empty {a:1} [1,2,3]

🔗 Result Handling — Chain Variables

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

toKebabCase()

+ Chain another variable

---

Related Variables

Same category: String

→ charAt → collapseWhitespace → concat → countWordsInString → endsWith → extract → extractFirstSegment → extractNumber → fromBase64 → indexOf → left → matchAll → matchRegex → normalizeEmail → normalizePhone → padEnd → padStart → parseJSON → replaceAll → replaceAllWithRegex → replaceFirst → right → safeSplit → search → slice → slugify → split → startsWith → stripAccents → stripHtml → substringAfter → substringBefore → test → toBase64 → toCamelCase → toJsonString → toLocaleLowerCase → toLocaleUpperCase → toLowerCase → toNumber → toSnakeCase → toStartCase → toString → toStringRepresentation → toUpperCase → toUpperFirst → trim → trimEnd → trimStart → truncate

---

Under the Hood

📜 View Implementation Code

/**
* Converts a string to kebab-case format.
*
* @param {string} data.src - The string to convert to kebab-case.
* @param {Function|string} [data.out] - Optional output handler: function to transform result or string with format.
*
* Direct-mode specific parameters:
* @param {Function} [data.pre] - Optional pre-processor function to transform src before conversion.
*
* @returns {string|undefined} The string in kebab-case format, or undefined if the input is not a valid string.
*
* @framework ggLowCodeGTMKit
*/
const toKebabCase = function(string) {
   if (typeof string === 'string') {
       const pattern = "[_\\s-]+";
       const replacement = '-';

       const replaceAllWithRegex = function(input, pattern, replacement) {
           if (typeof input !== 'string' || typeof pattern !== 'string' || typeof replacement !== 'string') {
               return input;
           }
           let result = input;
           let lastIndex = 0;

           while (lastIndex < result.length) {
               const remainingStr = result.substring(lastIndex);
               const matchObj = remainingStr.match(pattern);
               if (matchObj === null) {
                   break;
               }

               const actualMatchIndex = lastIndex + (matchObj.index || 0);

               result = result.substring(0, actualMatchIndex) +
                        replacement +
                        result.substring(actualMatchIndex + matchObj[0].length);
               lastIndex = actualMatchIndex + replacement.length;
           }
           return result;
       };

       let result = replaceAllWithRegex(string, pattern, replacement);

       result = result.toLowerCase();
       return result;
   }
   return undefined;
};
const safeFunction = fn => typeof fn === 'function' ? fn : x => x;
const out = safeFunction(data.out);
// ===============================================================================
// toKebabCase - Direct mode
// ===============================================================================
const applyCast = (castFn, value) => safeFunction(castFn)(value);
const value = applyCast(data.pre, data.src);
return out(toKebabCase(value));

// ===============================================================================
// toKebabCase() – Apply Mode
// ===============================================================================
/*
return function(value) {
  return out(toKebabCase(value));
};
*/

🧪 View Test Scenarios (5 tests)

✅ '[example] Spaces to kebab-case'
✅ '[example] Underscores to kebab-case'
✅ Mixed case string with multiple separators - should convert to kebab-case
✅ Already in kebab-case - should remain unchanged
✅ '[example] Non-string input returns undefined'