Sass meta.get-mixin() Function

What You’ll Learn

meta.get-mixin() belongs to the built-in sass:meta module. It turns a mixin name into a mixin value you can store, pass around, and include with meta.apply. This page covers $module, @content, vs get-function, Dart Sass 1.69+, and five compiled examples.

What Is meta.get-mixin()?

Normally you write @include card; with a fixed name. Higher-order helpers need a reference to a mixin instead. Official docs: meta.get-mixin returns the mixin value named $name, and you include it with meta.apply().

• Without $module, looks up a mixin defined in the current module.
• With $module, looks inside a @use namespace from the current file.
• Missing names throw by default—use meta.mixin-exists for optional APIs.

📝 Syntax

@use "sass:meta";

// Recommended — Dart Sass 1.69+
meta.get-mixin($name, $module: null)

Parameters

Return value

Unlike meta.get-function, there is no $css flag—mixin names must resolve to real Sass mixins.

📦 Loading sass:meta

// Recommended — namespaced
@use "sass:meta";

@mixin stamp {
  color: teal;
}

$m: meta.get-mixin("stamp");
.box {
  @include meta.apply($m);
}

// Optional — bring members into scope
@use "sass:meta" as *;
$m: get-mixin("stamp");
@include apply($m);

// Alias
@use "sass:meta" as m;
$m: m.get-mixin("stamp");
@include m.apply($m);

🔗 Pair with meta.apply

Official rule: the returned mixin is included using meta.apply(). Remember apply is a mixin—always use @include.

@use "sass:meta";

@mixin pad($n) {
  padding: $n;
}

$mx: meta.get-mixin("pad");

.card {
  @include meta.apply($mx, 1rem);
}

// Optional @content is forwarded into the applied mixin
@include meta.apply($mx, 0.5rem) {
  // only useful if the target mixin uses @content
}

📋 Related Meta Helpers

🛠 Compatibility

This is about Sass compilers, not browsers. Resolution runs at compile time.

Prefer current Dart Sass 1.69+ for get-mixin and apply.

Examples Gallery

Each example resolves a mixin value, then includes it with meta.apply. Open View Compiled CSS for verified Dart Sass output (1.69+).

@use "sass:meta";

@mixin stamp {
  color: teal;
  font-weight: 700;
}

$mx: meta.get-mixin("stamp");

.box {
  @include meta.apply($mx);
}

.box {
  color: teal;
  font-weight: 700;
}

@use "sass:meta";

@mixin apply-to-all($mixin, $list) {
  @each $element in $list {
    @include meta.apply($mixin, $element);
  }
}

@mixin font-class($size) {
  .font-#{$size} {
    font-size: $size;
  }
}

$sizes: 8px, 12px, 2rem;

@include apply-to-all(meta.get-mixin("font-class"), $sizes);

.font-8px {
  font-size: 8px;
}

.font-12px {
  font-size: 12px;
}

.font-2rem {
  font-size: 2rem;
}

@use "sass:meta";

@mixin solid {
  border: 2px solid #334155;
}

@mixin dashed {
  border: 2px dashed #94a3b8;
}

$style: "solid";
$mx: if(
  $style == "solid",
  meta.get-mixin("solid"),
  meta.get-mixin("dashed")
);

.panel {
  @include meta.apply($mx);
}

.panel {
  border: 2px solid #334155;
}

@use "sass:meta";

@mixin frame {
  border: 1px solid #cbd5e1;
  padding: 1rem;
  @content;
}

$mx: meta.get-mixin("frame");

.card {
  @include meta.apply($mx) {
    color: #0f172a;
  }
}

.card {
  border: 1px solid #cbd5e1;
  padding: 1rem;
  color: #0f172a;
}

@use "sass:meta";

@mixin shell {
  display: block;
  @content;
}

$name: "shell";

.widget {
  @if meta.mixin-exists($name) {
    $mx: meta.get-mixin($name);
    @if meta.accepts-content($mx) {
      @include meta.apply($mx) {
        margin: 1rem;
      }
    } @else {
      @include meta.apply($mx);
    }
  }
}

.widget {
  display: block;
  margin: 1rem;
}

🚀 Real-World Use Cases

• Higher-order mixins — apply one mixin across a list of tokens (official apply-to-all).
• Theme switches — choose solid/dashed (or brand variants) from config.
• Plugin APIs — accept a mixin value from consumers instead of a fixed name.
• Content-aware wrappers — resolve, check accepts-content, then forward blocks.
• Module bridging — pull mixins from another @use namespace via $module.

⚠️ Common Pitfalls

• Treating apply like a function — always @include meta.apply(…).
• Missing name — throws; guard with meta.mixin-exists.
• Wrong $module — must match this file’s @use … as name.
• Confusing with get-function — mixins emit CSS; functions return values.
• Old Dart Sass — needs 1.69+ for mixin values.

💡 Best Practices