Welcome to the Subdomain Resolution Guide for Superlink’s free subdomain service. This guide outlines the necessary steps and prerequisites for resolving Superlink subdomains.
Before proceeding, ensure that the Superlink SDK is correctly installed and configured within your environment. For detailed instructions, please refer to our SDK Setup Guide.
Subdomain resolution comes in two forms: forward and reverse. Our API and SDK support both types of resolution, facilitating a comprehensive domain management experience.
Forward resolution involves providing a domain name to retrieve associated information, such as Ethereum addresses, text records, or content hashes. Use the Subdomain Resolve API for this purpose. By supplying the domain name, you can access all related information in a single request.
Reverse resolution allows you to input an Ethereum address and find out which domain points to it. This process is facilitated by the Subdomain Reverse Resolve API. By entering the Ethereum address associated with a domain, our service can return the corresponding domain name.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Superlink Documentation","colors":{"primary":"#854EFB","light":"#854EFB","dark":"#854EFB"},"favicon":"/favicon.png","logo":{"light":"https://mintcdn.com/superlink/6jy0IFpninB5T2R3/logo/superlink-light.png?fit=max\u0026auto=format\u0026n=6jy0IFpninB5T2R3\u0026q=85\u0026s=ffa53d186b28a8e3c8289b17e096a32e","dark":"https://mintcdn.com/superlink/6jy0IFpninB5T2R3/logo/superlink-dark.png?fit=max\u0026auto=format\u0026n=6jy0IFpninB5T2R3\u0026q=85\u0026s=592d741d83f14a7c22b1f3f8178f5abe"},"background":{"image":"https://assets.superlink.me/images/docs-background-image.png","decoration":null},"navbar":{"links":[{"label":"Support","href":"mailto:support@superlink.me"}],"primary":null},"footer":{"socials":{}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"superlink","hasAudioNarration":false,"actualSubdomain":"superlink","customDomains":["docs.superlink.me"],"gitSource":{"type":"github","owner":"superlink-me","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae91e714f09cc61811fa163:success","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"SDK Reference","count":30},{"language":"default","tag":"SDK Documentation","count":30},{"language":"default","tag":"API Reference","count":24},{"language":"default","tag":"API Endpoints","count":23},{"language":"default","tag":"Client SDK","count":22},{"language":"default","tag":"Examples","count":17},{"language":"default","tag":"ENS Free Subdomains","count":12},{"language":"default","tag":"Free Subdomains API","count":11},{"language":"default","tag":"Documentation","count":10},{"language":"default","tag":"Namespace management","count":9}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@import url(https://assets.superlink.me/fonts/planar.css);html,body,div,a{font-family:\"GT Planar Regular\"!important;letter-spacing:0px}"}],"page":{"pagePath":"sdk-reference/client-sdk/integration/free-subdomain-resolution","slug":"/sdk-reference/client-sdk/integration/free-subdomain-resolution","pageMetadata":{"title":"ENS Subdomain Resolution Guide","description":null,"href":"/sdk-reference/client-sdk/integration/free-subdomain-resolution"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Welcome to the Subdomain Resolution Guide for Superlink’s free subdomain service. This guide outlines the necessary steps and prerequisites for resolving Superlink subdomains.`}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.p,{children:[`Before proceeding, ensure that the Superlink SDK is correctly installed and configured within your environment. For detailed instructions, please refer to our `,_jsx(_components.a,{href:`/sdk-reference/client-sdk/setup`,children:`SDK Setup Guide`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`subdomain-resolution`,children:`Subdomain Resolution`}),`\n`,_jsx(_components.p,{children:`Subdomain resolution comes in two forms: forward and reverse. Our API and SDK support both types of resolution, facilitating a comprehensive domain management experience.`}),`\n`,_jsx(Heading,{level:`3`,id:`forward-resolution`,children:`Forward Resolution`}),`\n`,_jsxs(_components.p,{children:[`Forward resolution involves providing a domain name to retrieve associated information, such as Ethereum addresses, text records, or content hashes. Use the `,_jsx(_components.a,{href:`/sdk-reference/client-sdk/examples/free-subdomains/subdomain-resolve`,children:`Subdomain Resolve API`}),` for this purpose. By supplying the domain name, you can access all related information in a single request.`]}),`\n`,_jsx(Heading,{level:`3`,id:`reverse-resolution`,children:`Reverse Resolution`}),`\n`,_jsxs(_components.p,{children:[`Reverse resolution allows you to input an Ethereum address and find out which domain points to it. This process is facilitated by the `,_jsx(_components.a,{href:`/sdk-reference/client-sdk/examples/free-subdomains/subdomain-reverse-resolve`,children:`Subdomain Reverse Resolve API`}),`. By entering the Ethereum address associated with a domain, our service can return the corresponding domain name.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"ENS Subdomain Resolution Guide","description":null,"href":"/sdk-reference/client-sdk/integration/free-subdomain-resolution"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Subdomain Resolution","slug":"subdomain-resolution","depth":2,"children":[{"title":"Forward Resolution","slug":"forward-resolution","depth":3,"children":[]},{"title":"Reverse Resolution","slug":"reverse-resolution","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"superlink","siteName":"Superlink Documentation","title":"ENS Subdomain Resolution Guide - Superlink Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T00:46:23.358Z","originalFileLocation":"sdk-reference/client-sdk/integration/free-subdomain-resolution.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Superlink Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/superlink/yPl9kkDiWhOtywPq/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/superlink/yPl9kkDiWhOtywPq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/superlink/yPl9kkDiWhOtywPq/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/superlink/yPl9kkDiWhOtywPq/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/superlink/yPl9kkDiWhOtywPq/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/superlink/yPl9kkDiWhOtywPq/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/superlink/yPl9kkDiWhOtywPq/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/superlink/yPl9kkDiWhOtywPq/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/superlink/yPl9kkDiWhOtywPq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"ENS Subdomain Resolution Guide - Superlink Documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Superlink Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.superlink.me/sdk-reference/client-sdk/integration/free-subdomain-resolution\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://superlink.mintlify.site/_mintlify/api/og/v2?division=Integration+guides\u0026amp;title=ENS+Subdomain+Resolution+Guide\u0026amp;theme=45059c7451ef269975e397f9\u0026amp;signature=e6a50205ff517522d232673506ea536bc8bbec088f92280aab6c87f94f05d35c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"ENS Subdomain Resolution Guide - Superlink Documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://superlink.mintlify.site/_mintlify/api/og/v2?division=Integration+guides\u0026amp;title=ENS+Subdomain+Resolution+Guide\u0026amp;theme=45059c7451ef269975e397f9\u0026amp;signature=e6a50205ff517522d232673506ea536bc8bbec088f92280aab6c87f94f05d35c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/superlink/yPl9kkDiWhOtywPq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Superlink Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#854EFB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.superlink.me/sdk-reference/client-sdk/integration/free-subdomain-resolution\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/sdk-reference/client-sdk/integration/free-subdomain-resolution.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.superlink.me/#organization\",\"name\":\"Superlink Documentation\",\"url\":\"https://docs.superlink.me\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/superlink/6jy0IFpninB5T2R3/logo/superlink-light.png?fit=max\u0026auto=format\u0026n=6jy0IFpninB5T2R3\u0026q=85\u0026s=ffa53d186b28a8e3c8289b17e096a32e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.superlink.me#website\",\"name\":\"Superlink Documentation\",\"url\":\"https://docs.superlink.me\",\"publisher\":{\"@id\":\"https://docs.superlink.me/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.superlink.me/sdk-reference/client-sdk/integration/free-subdomain-resolution#webpage\",\"url\":\"https://docs.superlink.me/sdk-reference/client-sdk/integration/free-subdomain-resolution\",\"name\":\"ENS Subdomain Resolution Guide\",\"dateModified\":\"2026-01-07T00:46:23.358Z\",\"isPartOf\":{\"@id\":\"https://docs.superlink.me#website\"},\"breadcrumb\":{\"@id\":\"https://docs.superlink.me/sdk-reference/client-sdk/integration/free-subdomain-resolution#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.superlink.me/sdk-reference/client-sdk/integration/free-subdomain-resolution#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SDK Documentation\",\"item\":\"https://docs.superlink.me/sdk-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Client SDK\",\"item\":\"https://docs.superlink.me/sdk-reference/client-sdk/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Integration guides\",\"item\":\"https://docs.superlink.me/sdk-reference/client-sdk/integration/free-subdomain-onboarding\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"ENS Subdomain Resolution Guide\",\"item\":\"https://docs.superlink.me/sdk-reference/client-sdk/integration/free-subdomain-resolution\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.superlink.me/sdk-reference/client-sdk/integration/free-subdomain-resolution#article\",\"headline\":\"ENS Subdomain Resolution Guide\",\"name\":\"ENS Subdomain Resolution Guide\",\"url\":\"https://docs.superlink.me/sdk-reference/client-sdk/integration/free-subdomain-resolution\",\"mainEntityOfPage\":{\"@id\":\"https://docs.superlink.me/sdk-reference/client-sdk/integration/free-subdomain-resolution#webpage\"},\"dateModified\":\"2026-01-07T00:46:23.358Z\",\"publisher\":{\"@id\":\"https://docs.superlink.me/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.superlink.me#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Superlink Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Superlink Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"SDK Reference","groups":[{"group":"SDK Documentation","pages":[{"title":"Introduction","href":"/sdk-reference/introduction"},{"group":"Client SDK","pages":[{"title":"Overview","href":"/sdk-reference/client-sdk/overview"},{"title":"Installation and Setup","href":"/sdk-reference/client-sdk/setup"},{"group":"Integration guides","pages":[{"title":"ENS Subdomain Onboarding Guide","href":"/sdk-reference/client-sdk/integration/free-subdomain-onboarding"},{"title":"ENS Subdomain Management Guide","description":null,"href":"/sdk-reference/client-sdk/integration/free-subdomain-management"},{"title":"ENS Subdomain Resolution Guide","href":"/sdk-reference/client-sdk/integration/free-subdomain-resolution"}]},{"group":"Examples","pages":[{"group":"Partner API","pages":[{"title":"Access Tokens","description":null,"href":"/sdk-reference/client-sdk/examples/partner/access-tokens"},{"title":"Purchase History","href":"/sdk-reference/client-sdk/examples/partner/purchases"}]},{"group":"Free Subdomains API","pages":[{"group":"Parent domain onboarding","pages":[{"title":"Onboard existing parent domain","href":"/sdk-reference/client-sdk/examples/free-subdomains/parent-domain-onboard-existing"},{"title":"Search available parent domain","href":"/sdk-reference/client-sdk/examples/free-subdomains/parent-domain-search"},{"title":"Purchase parent domain","href":"/sdk-reference/client-sdk/examples/free-subdomains/parent-domain-purchase"}]},{"group":"Parent domain info","pages":[{"title":"List subdomains","href":"/sdk-reference/client-sdk/examples/free-subdomains/subdomain-list"},{"title":"Subdomain total created","href":"/sdk-reference/client-sdk/examples/free-subdomains/subdomain-total"},{"title":"Subdomain created per-day","href":"/sdk-reference/client-sdk/examples/free-subdomains/subdomain-per-day"}]},{"group":"Subdomain management","pages":[{"title":"Subdomain availability","href":"/sdk-reference/client-sdk/examples/free-subdomains/subdomain-available"},{"title":"Create subdomain","href":"/sdk-reference/client-sdk/examples/free-subdomains/subdomain-create"},{"title":"Revoke Subdomain","href":"/sdk-reference/client-sdk/examples/free-subdomains/subdomain-revoke"}]},{"group":"Subdomain resolution","pages":[{"title":"Subdomain forward resolution","href":"/sdk-reference/client-sdk/examples/free-subdomains/subdomain-resolve"},{"title":"Subdomain reverse resolution","href":"/sdk-reference/client-sdk/examples/free-subdomains/subdomain-reverse-resolve"}]}]},{"group":"Headless Marketplace API","pages":[{"title":"Coming soon!","href":"/sdk-reference/client-sdk/examples/headless-marketplace/coming-soon"}]},{"group":"Domain Resolution API","pages":[{"title":"Forward Resolution","href":"/sdk-reference/client-sdk/examples/resolution/forward-resolution"},{"title":"Reverse Resolution","href":"/sdk-reference/client-sdk/examples/resolution/reverse-resolution"},{"title":"Design Recommendations","href":"/sdk-reference/client-sdk/examples/resolution/design-recommendations"}]}]}]},{"group":"React SDK","pages":[{"title":"Overview","href":"/sdk-reference/react-sdk/overview"},{"title":"Integration Guide","href":"/sdk-reference/react-sdk/integration"},{"title":"Quick example","href":"/sdk-reference/react-sdk/examples"},{"title":"Advanced configuration","href":"/sdk-reference/react-sdk/advanced-configuration"}]},{"group":"Android SDK","pages":[{"title":"Overview","href":"/sdk-reference/android-sdk/overview"},{"title":"Integration Guide","href":"/sdk-reference/android-sdk/integration"}]},{"group":"iOS SDK","pages":[{"title":"Coming soon!","href":"/sdk-reference/ios-sdk/overview"}]}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"ENS Subdomain Resolution Guide - Superlink Documentation","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":[],"chunks":[]}
