Install guide

The snippet

Paste this once into any page (or your theme's footer) where you want SuperHref to scan and enrich Amazon & eBay links:

<script src="https://superhref.com/src/index.js" data-key="YOUR_API_KEY" async></script>

That's it — no other configuration needed. The script scans the page on load, rewrites product links with your affiliate tags, and inserts replacement carousels for unavailable items.

Optional configuration

For most sites the snippet above is everything you need. SuperHref automatically captures the page URL of every event so you can see which pages are driving impressions and clicks in your dashboard.

WordPress

Easiest: use a free plugin like Insert Headers and Footers (by WPCode) or Header Footer Code Manager:

1. In your WordPress admin, go to Plugins → Add New, search "Insert Headers and Footers", install & activate.
2. Go to Settings → Insert Headers and Footers.
3. Paste the snippet into the Scripts in Footer box. Save.

SuperHref will now run on every page of your site.

add_action('wp_footer', function () { ?>
  <script src="https://superhref.com/src/index.js" data-key="YOUR_API_KEY" async></script>
<?php });

Shopify

1. In your Shopify admin: Online Store → Themes → Actions → Edit code.
2. Open layout/theme.liquid.
3. Paste the snippet just before the closing </body> tag.
4. Save.

Squarespace

1. Go to Settings → Advanced → Code Injection.
2. Paste the snippet into the Footer box.
3. Save.

Note

Wix

1. From your dashboard: Settings → Custom Code (under "Advanced").
2. Click Add Custom Code.
3. Paste the snippet, set Place Code in = "Body - end", apply to "All pages".
4. Click Apply.

Note

Webflow

1. Open your project: Project Settings → Custom Code.
2. Paste the snippet into the Footer Code field.
3. Save and republish your site.

Ghost

1. In your Ghost admin: Settings → Code injection.
2. Paste the snippet into the Site Footer field.
3. Save.

Blogger

1. Go to Theme → Edit HTML.
2. Find </body> and paste the snippet just before it.
3. Save theme.

Tumblr

1. Go to Edit appearance → Edit theme → Edit HTML.
2. Paste the snippet just before </body>.
3. Update preview, then save.

Joomla

Easiest: use the free Sourcerer or JCH Optimize Custom HTML extension. Or:

1. Go to Extensions → Templates → Templates, click your active template.
2. Open index.php, paste the snippet just before </body>.
3. Save.

Drupal

1. Go to Structure → Block layout → Custom block library, click Add custom block.
2. Set the body's text format to Full HTML, paste the snippet into the body.
3. Save, then place the block in a footer region under Block layout.

Discourse

Discourse is a single-page Ember app — pasting the standard snippet into the theme's </body> tab runs once, scans an empty DOM (post content hasn't mounted yet), and never re-runs as users click between topics. Use the dedicated theme component instead: it loads SuperHref once and drives SuperHref.enrich() per post via Discourse's decorateCookedElement API, so it works correctly across navigation and as new posts stream into long topics.

1. Go to Admin → Customize → Themes, click Install, choose From a git repository.
2. Paste https://github.com/forumcopilot/superhref-discourse and click Install.
3. Open your active theme (Customize → Themes → your theme) and add SuperHref under the Components section.
4. Click into the SuperHref component, open the Settings tab, paste your YOUR_API_KEY into the api_key field, and save.

Source, full configuration reference, and notes on coexisting with the official discourse-affiliate plugin: forumcopilot/superhref-discourse.

phpBB

1. In your phpBB admin: Styles → Templates → Modify.
2. Edit overall_footer.html.
3. Paste the snippet just before </body>. Save.
4. Go to General → Server configuration → Load settings → Purge the cache.

XenForo

1. Go to Admin Control Panel → Appearance → Templates.
2. Find & edit PAGE_CONTAINER.
3. Paste the snippet just before </body>. Save.

vBulletin

1. Go to AdminCP → Styles & Templates → Style Manager.
2. Edit your active style, find the footer template.
3. Paste the snippet just before </body>. Save.

MyBB

1. Go to AdminCP → Templates & Style → Templates.
2. Edit your active theme's Footer Templates → footer.
3. Paste the snippet just before </body>. Save.

Flarum

No extension install required if your host has the standard Custom Footer HTML field in the admin (FreeFlarum and most managed Flarum providers include it by default):

1. Log in as admin → Administration → Appearance (or the equivalent "Custom Footer HTML" setting for your host).
2. Paste the snippet into the Custom Footer HTML field.
3. Click Save Changes. Done — no rebuild needed.

Static HTML / Any other site

Paste the snippet just before the closing </body> tag of any HTML page:

  <!-- ...your page content... -->

  <script src="https://superhref.com/src/index.js" data-key="YOUR_API_KEY" async></script>
</body>
</html>

Google Tag Manager

1. In GTM, create a new Custom HTML tag.
2. Paste the snippet into the HTML field.
3. Set the trigger to All Pages (or a more specific page filter if you only want it on certain URLs).
4. Save and publish your container.

How to verify it's working

1. Open a page on your site that contains an Amazon or eBay link.
2. Right-click the link → Copy link address (or hover and look at the status bar). You should see your affiliate tag (?tag=... or ?campid=...) appended.
3. For unavailable products, a small carousel of replacement items should appear right after the link.
4. If you're signed in, your dashboard's recent events table will show every link the script processed.

Troubleshooting

SuperHref.enrich({
  apiKey: 'YOUR_API_KEY',
  getInsertPoint: function (anchorEl) {
    // Insert after the anchor's parent <p> instead of right after the link
    return anchorEl.closest('p') || anchorEl;
  },
});