STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: /docs/alloy/v1.16/reference/config-blocks/import.string.md (append .md) or send Accept: text/markdown to /docs/alloy/v1.16/reference/config-blocks/import.string/. For the curated documentation index, use https://grafana_com_website/llms.txt. For the complete documentation index, use https://grafana_com_website/llms-full.txt.

Reference

Configuration blocks

import.string

General availability (GA) Open source

import.string

The import.string block imports custom components from a string and exposes them to the importer. import.string blocks must be given a label that determines the namespace where custom components are exposed.

Usage

import.string "<NAMESPACE>" {
  content = <CONTENT>
}

Arguments

You can use the following argument with import.string:

Name	Type	Description	Default	Required
`content`	`secret` or `string`	The contents of the module to import as a secret or string.		yes

content is a string that contains the configuration of the module to import. content is typically loaded by using the exports of another component. For example,

local.file.<LABEL>.content
remote.http.<LABEL>.content
remote.s3.<LABEL>.content

Example

This example imports a module from the content of a file stored in an S3 bucket and instantiates a custom component from the import that adds two numbers:

remote.s3 "module" {
  path = "s3://test-bucket/module.alloy"
}

import.string "math" {
  content = remote.s3.module.content
}

math.add "default" {
  a = 15
  b = 45
}