Core Concepts
Understanding module types and how they integrate with the LinkWrangler ecosystem.
Actions vs. Integrations
When building a module, the first decision you must make is its Type. This determines where your module appears in the dashboard and how users interact with it.
Action Modules
Actions are functional units used inside the Rule Builder. They are triggered when specific conditions are met (e.g., "If Country is US → Show Banner").
- ✓Can be used multiple times in different rules
- ✓Has its own configuration schema (`action_schema`)
- ✓Example: Promotional Banner, Redirect, OTP Gate
Integration Modules
Integrations are account-wide services that run globally on all pages. They are configured once in the Module Settings.
- ✓Configured once per account
- ✓Uses `settings_schema` for configuration
- ✓Example: Analytics Pixels, Chat Widgets, SEO Tools
Lifecycle Management
LinkWrangler provides a built-in interface for managing your custom modules entirely from the dashboard.
1. Creating a Module
Navigate to Module Development → My Custom Modules tab. Click the Create Module button to open the editor. You can paste your JSON definition directly here.
2. Editing & Updates
Click the ✎ (Edit) icon on any custom module card to reopen the editor.
Note: Changes to the module definition (e.g., adding a new field) apply immediately. However, existing installations will only use the new fields once the user re-saves their configuration.
3. Deleting Modules
Click the 🗑 (Trash) icon to delete a module.
- If the module is installed, this action will uninstall it first (removing it from active use).
- If the module is not installed (and is a custom module), this will permanently delete the module definition from your account.