For AI agents: a Markdown version of this page is at https://docs.snowplow.io/docs/pipeline/enrichments/managing-enrichments.md. The index of all documentation pages is at https://docs.snowplow.io/llms.txt, and the index for this section is at https://docs.snowplow.io/docs/cdi/llms.txt.
Manage enrichments in Console
Snowplow Console enables you to manage enrichments that run on each of your pipelines and development environments.
Recommended workflow
You can enable and edit enrichments on any pipeline, but we recommend the following workflow to test the configuration before deploying it:
- Navigate to a development environment (based on Snowplow Micro)
- Enable and configure the enrichment as required
- Send some events to the environment's endpoint and validate the fields appear as expected in the event payload
- Deploy the configuration to your pipeline(s)
Alternatively, you can use Snowplow Micro to test your changes locally.
Invalid enrichment changes can halt data processing in the pipeline. For example, an enrichment might be pointing to a non-existent database file, or the JavaScript code in the JavaScript enrichment might have typos. This is why we recommend testing in a low-risk environment first.
Configure an enrichment
Within Console, use the Pipelines section to navigate to the pipeline or development environment where you would like to change the enrichment. Open the Enrichments tab. You will see a listing of all enrichments and their current status (enabled or disabled).
Click on the enrichment you want to change. You will see the current configuration if the enrichment is enabled, and the default one if it's not. For each enrichment, the reference on the configuration format is linked in the top navigation bar.
- To enable or edit the enrichment, click on Edit configuration. Adjust the configuration and click Publish to deploy the changes. This will enable the enrichment if it was disabled.
- To disable the enrichment, click on the ⋮ menu and select Disable.
Never put credentials, API keys, or salts directly in your enrichment configuration. For enrichments that require secrets (e.g., API Request enrichment, SQL Query, PII Pseudonymization), use the Credentials Sharing Form to share sensitive information with Snowplow. The Support team will place the secrets in secured environment variables on your behalf.
Deploy an enrichment from a development environment to a pipeline
If you followed the recommended workflow to test an enrichment in a development environment, you will need to copy the same configuration into a pipeline.
To do that, navigate to the development environment under Pipelines, select the Enrichments tab and click on the enrichment in question. Then click Deploy, select the desired pipeline and click Deploy configuration.
An AI assistant connected to the Snowplow MCP server can show which enrichments are enabled on each pipeline and development environment, and update their configuration for you. Follow the same recommended workflow: ask it to change a development environment first, then deploy the tested configuration to your pipeline. For example: "Enable the IP lookups enrichment on my development environment, and show me the configuration before you publish it." Don't paste credentials or other secrets into the conversation.
Install the Snowplow MCP server and skills in your coding agent, such as Claude Code, Cursor, or Codex, with npx plugins add snowplow/skills. In Console, the Snowplow Assistant has the same tools.