---
title: Custom import paths for Go modules
published_on: '2025-02-13'
---

*Updated 6/4/2025: Replaced the demo page.*

Go modules are great. URL-based imports, generally, are great. One of the things that makes them so great is that putting them on your own domain provides a good way of verifying ownership without going through a third party or a complicated review process. Plus, it looks cool.

So, how exactly does one accomplish such a thing? Well, it's [buried in the documentation](https://pkg.go.dev/cmd/go#hdr-Remote_import_paths), but it's really pretty simple. For each import path (e.g. `mysite.com/mypackage`), just put a page on your website with a `go-import` meta tag:

~~~ html
<meta name="go-import" content="mysite.com/mypackage git https://ultragreatgithost.com/me/mypackage">
~~~

_(`git` can be replaced with `bzr`, `fossil`, `hg`, or `svn` for different VCSs &mdash; see the docs page linked above.)_

This website, for instance, builds these pages from a hash in [`build.rb`](https://git.sr.ht/~aleksrutins/farthergate.com/tree/main/item/build.rb#L14):

~~~ ruby
def go_modules = {
  "farthergate.com/stack" => "https://git.farthergate.com/aleks/stack",
  # ...
}
~~~

See [farthergate.com/terminated](/terminated) for an example of a generated page. Look in the web inspector for the `meta` tag!