Welcome to the Referric Documentation


Referric is the first white label solution for casino and sportsbook affiliates. Our extensive package includes design, front-end, back-end and hosting. You can now launch new affiliate websites in a matter of days. Referric was designed to make casino and sportsbook affiliates' job easier with a feature-rich solution that fullfills the technical requirements for your new website to rank well on search engines' result pages, as well as offer a pleasant user experience that your visitors will love. Referric is a platform that is super fast, easy to use and is professionally built with the latest technologies available. What you get with Referric: • your own theme that makes your website unique • a performance and user experience optimised affiliate website • an easy to use content management system that allows you to edit your new website's content • cloud-based hosting up to 100GB traffic / month This documentation will walk you through everything that you need to know about the platform, including some advanced tips for further customisation.

Getting Started

Once you purchased your new Referric site, there are a few steps required to get it up and running. To help us in setting up your custom theme, share the following with us: • your new website's logo (in SVG format) • your background image (1920x1080px, svg recommended) - optional, less images means faster page load time • your website font(s) - (variable font format recommended) don't forget to purchase a font lincense if required for commercial use • your desired theme color(s) if any - color names (with image examples) or color codes • and pick a layout to use for your new website from the images showing below: referric layout options These layout options mostly affect the desktop view of the website. Tip: We also have a theme developer tool that you can try if you wish to to check out different color combinations before you decide on how you want to style your new website. Once you are satisfied with the colors, you can send us the code block visible at the bottom of the screen to speed up the launch process even more. The next important step in setting up your website is connecting it to your custom domain name.

Custom Domain Name

To set up a custom domain name for your website, you will need a domain name purchased from a domain name provider (eg. Namecheap, Google Domains, Domain.com etc.). To connect it to your new Referric website you have two options: Send us your login details (username and password) to your domain name provider's website which is required to set up nameservers and DNS records to connect your domain name. Once the setup is done you can change your password. or Follow the instructions below to set up the nameservers and DNS records.

DNS record setup To connect your new website to your domain name: 1. Log in to your domain name provider's website 2. Choose the domain name you would like to use for your new Referric site 3. Look for DNS records option 4. Save all DNS records (so you have a backup of the old records) 4. Add a new "CNAME type" DNS record (or replace the one if already exists) to the list with the following settings.
Name: @
Value: yoursite.app *
TTL: 3600 seconds
* The Value entry is website specific, and will be provided after purchase.

CMS Overview

Your new website's CMS will be available at yoursite.com/admin/ You will receive your admin user details (username and password) from Referric via e-mail. Once you've successfully logged in you have full access to create pages and edit them. You can have up to four CMS/back-end users per website (please note that all users will have admin role and will be able to create and delete content and pages). Whilst most of the features are self-explanatory, if you ever get stuck or can't find something, you'll definitely find the answer you are looking for here in the documentation. There are two main views in the CMS: Contents and Media (found in the middle of the header on top)

referric cms viewreferric cms header selection
Contents view Allows you to create (or delete) pages and edit them
Media view Allows you to manage images (to be used for casino logos, find more info here about images for pages) for your website.
Quick Add To quickly add new page you can use the "Quick add" button (found in the top right corner). The following options are available: Main Pages and/or Reviews (pages) - these refer to the pages of your website. With the Compliance option you can also add complaince logos to include in the footer of all pages. The CMS' Contents view lists the available page types you can edit in the left side panel. You can edit all types of pages but you can only create/delete pages that are in the "Reviews" and in the "Main pages" category.

Important Information!

Once you have access to your CMS and start deleting the existing placeholder pages, keep in mind to always keep one review page that has the "monthly" tag, otherwise the site building will fail. If you have already deleted the placeholder monthly casino, you can simply create a new temporary review page and add the "monthly" tag (without the quote marks) in the tags/categories field, save the changes, and the build should be successful afterwards. Subsections in guides/reviews To add more sub-sections to your guide or review text contents, you can use to visually highlight subtitles with:
<span>Subtitle here</span>
<h4>Subtitle here</h4>
<p class="guide-text sectioned animate-me fancy">
to make it actual SEO friendly subtitles. The second option closes the text box, adds a H4 title, and reopens the textbox.

Page Categories

You can find the page categories panel (which also includes settings and translations) on the left side of the CMS' main view.
referric cms viewreferric sidebar selection

Reviews Casino/sportsbook specific pages that contain all the information for each casino/sportsbook (and also feed content into the main pages' specific sections: the list of casinos/sportsbooks right at the top of the page under the main title and intro text card, the casino of the month card, the card that also shows the casino of the month next to the guide text in desktop view and after the guide text where there is a quick selection box for the top 10 casinos showing globally on the website. Main pages The pages that will appear in the top navigation menu (up to 10 pages) and the footer of your website (maximum of 40 pages, including the pages that appear in the top navigation menu of the website). These pages have unique URL - this can only be set when creating the page. To rename a page you have to create another one with the desired url and delete the previous one. Home page The main landing page of the website which generally behaves the same way as other Main pages, but the difference is that you can't delete it (or create new ones). Here you don't have to worry about the URL of the page as it always will be the root of your website which will be available under your domain name directly (eg. www.mydomain.com/ ). About Us, Responsible Gaming and Privacy Policy These are generic text pages. Contact Us This page has a contact form that you can connect with an email address of your choice to receive messages from the page to your mailbox. Settings and Translations This section includes global settings for the website as well as options to translate static page contents (eg. buttons, footer texts, and other static content). You can also set legal compliance text here for the footer. Compliance This section includes a preset of organisation logos that you can include in the footer of your pages. It is an extensive list, but definitely not all of the organisations that exist globally, so we also included options to add your own ones or let us know if you are missing a few and we will add it to the list of available options.


Review pages are the individual pages for casinos (or sportsbooks). Most of the fields in the edit view are self-explanatory, but some require more attention and a little bit of explanation.

referric cms viewreferric cms header selection
Going on the edit page from top to bottom, here are the fields that do require some explanation: Page title: You can add a page title here that is independent of the Casino's name (eg. Super Casino Review - The best nft casino online this month). Casino logo: You have to upload svg logo of the casino after opening the gallery popup (top right corner) or in the main view of the CMS to be able to select the casino's logo in this field. SVG format recommended for all casino logos you upload (but not restricted to SVGs). Casino Name: When you create a new review page, this is the field that will set the url of the page as well as the casino's name (you can use any character, the name will be converted to a URL friendly character format for the URL of the page). Casino Score: You can rate all casinos with decimals or whole numbers ranging from 0-10 or 0-100. You can type in anything in the field, even text, but you won't be able to save the review page, so stick with numbers. Tags / Categories: One of the most important fields of the review page. You can type in categories (anything you want to have as a category - use simple english characters, this filter is only for routing and won't be directly visible on the website) and separate them with commas. We have a reserved keyword to make a casino appear in the main pages' "Casino of the Month" box, to use that simply add the category "monthly" (without quote marks) to the tags list. You can use the casino of the month (monthly) category on multiple casinos edit page, but only one will show on the website as the actual casino of the month. To avoid conflict with previous "casino of the month" casinos, remove the "monthly" tag from those (only one casino should have the tag to work correctly). Since this field requires matching tags to the home page and main pages categories that you can filter casinos with, please read the corresponding Tags field guide in the Main Pages section as well (look for "Page Category Filter"). Order in casinos list: A numeric value that determines where a casino will show up in list views on your pages. Since this is a global value, it will affect all pages (and will ignore filtering, meaning the casino will be hidden but wont give the numeric value it has to the next casino). If you have a casino that is set to #1 and it is set to show on one page, it will be the first casino in the list, but if it doesn't have a matching tag - meaning it is hidden on a specific page - then the first casino to show on that page will be #2 (or another casino that also has #1 as the order number). Since you can type in the same number for multiple casinos, think of this number as a global value when determining where you want a specific casino to show in all lists. CTA Link: This is where you can add the link to the casino you want to promote. T&C Link: This is where you can link a terms and conditions page of the promoted casino if it has one for the welcome bonus. Many websites simply use the same link as the CTA if regulations doesn't require directly linking to the terms page of the casino. URL relationships: You can set the "rel" (short for relationship) attribute of the CTA and the T&C links with this field. You can select one, multiple or no tags. Here is a list of what each option means: - sponsored: paid link content - external: links to a page outside of the website - nofollow: url links to an unendorsed page - eg. paid link - noopener: requires that browsing context created by clicking the link mustn't have an opener tag - noreferrer: hides the referrer (makes it unknown) - noindex: tells search engines not to index the page Bonus Code: You can set a bonus code for the casino or sportsbook if they offer one for players to activate a bonus. This field is hidden by default, and you can make it visible by adding something in the field and saving the page. The following fields are self-explanatory, and there are a few fields at the bottom of the page that require explanation. Last Title and Last Section: This field always should containt the last section of the review page's long text content (if it only has two sections, this should be the second one, if it has 10 sections filled in with content then the normal sections should end with the 9th section and this should contain the 10th sections content). This is important, and you actually wont be able to save the page if these fields are left blank, because the review pages structure requires an extra section to be filled with content, otherwise the right side panel that floats next to the texts (in desktop view) would cover in the FAQ section of the page and wont be hidden by the time the visitor scrolls down to the FAQ section. So each review page can actually hold 20+1 text sections, not 20. FAQ questions and answers: The minimum amount of Q/A to be used is two per page. Page meta description: This field is important for SEO purposes to be filled with a description that search engine results pages will show as a short description of the pages content. FAQ Schema JSON code: You can include a structured data JSON here that is in the FAQ format, which shows on google as answers to questions that a person gets when they search with a question. This JSON can include the same, more, less ( or even none) questions and answers than the on-page FAQ section, it is independent of it. Review Schema JSON code: Similar to the FAQ Schema, it supports rich results on search engine result pages, and you can include JSON that describes the casino and its scoring. Geo tags and 3rd party links: This section is the place where you can include google search console meta tag, or other 3rd party links, as well as GEO tags that are also beneficial for SEO.

Main Pages

Main pages are the backbone of your website. You can have up to 40 main pages of which 10 can show in the header menu and the rest of the pages will only show in the footer section of every page. Each main page has the same structure as your home page, but the difference is that you can create and delete main pages, which you can't do with the home page. Important! To have a matching URL with the page's name for each main page you should delete the ones that you don't need and create a new main page with the correct name for the URL. The file name of each main page is created with the page itself and can not be modified later.

referric cms viewreferric cms header selection
Here is the list of the editable fields with explanation (some fields are left out of this list as they are self-explanatory). Page URL / Page title in menus: This is where you can name the page when creating a new page. If you edit an existing page and change this field's value it will only update the page title in the menu and will cause a mismatch with its URL. To have the same title in both the menu and the URL you need to create a new page. Page Title: This is your page's title displayed in browsers tabs and as search engine result. Page Meta Description: This description is what search engines will show in results pages for your page. Order in Menu: You can arrange page order with this numeric value. Main pages start from the second place since Home page will always keep the first place for itself. You can rename and repurpose the home page to any topic since you dont have to change its URL, and its always gonna be available directly from your domain name. Page Category Filter: This field is one of the most important ones as this is where you can create and apply filters that you can filter the casino list on each page with. You can use custom one word filters (use simple english characters, this filter is only for routing and won't be directly visible on the website). These filters are applied to the page by simply saving the changes in the CMS. Once some tags (filters) are applied to the page, you can use the same tag for the casinos you want to show on that specific page. You can read about the casino review pages filtering in the review section's corresponding field (look for the "Tags / Categories" field's description). Page Headline (h1): This is the H1 title of your page. There is a limited space available in the box where this shows, so it is recommended to keep the title below 45 characters. Short Intro Text: This text will show directly below the H1 title on the front side of the first big card on the page. Long Intro Text: This is the content of the back side of the H1 and short intro text card. The next section is the casino (or sportsbook) list, which you can't edit here on the page. To have content in the list you have to create the review pages first - so you have information that directly feeds into the casino list. Once you have enough review pages that you want to show on a specific main page (or the home page) you can apply a matching filter to "Page Category Filter" of the main page (or home page) and to the "Tags / Categories" field of the review itself that needs to show on that specific page. This way you will show only the casinos or sportsbooks that have a matching tag. You can come up with any topic for the categories that you think you will use, dont worry about how it looks, it is only used for routing, so these tags wont be visible on your website (use simple english characters, and individual words for each category/tag). The following sections are self-explanatory and only hold text content. The next field that requires some explanation is the FAQ section. You need to have at least 2 Questions and answers in place to be able to save the page, that is the minimum for each page. Try to keep the answers similar length to each other so it wont cause layout issues. FAQ Schema JSON code: You can use a structured data JSON here that is in the FAQ format, which shows on google as answers to questions that a person gets when they search with a question. This JSON can include the same, more, less ( or even no) questions and answers than the on-page FAQ section, it is independent of it. Review Schema JSON code: Similar to the FAQ Schema, it supports rich results on search engine result pages, and you can include JSON that describes the casino and its scoring. You can include any of the casinos shown on the page in this JSON, it is independent in content to the page. Geo tags and 3rd party links: This section is the place where you can include google search console meta tag, or other 3rd party links, as well as GEO tags that are also beneficial for SEO. The last two fields are only for page routing and you dont have to do anything with these fields. If their content is deleted by mistake, you can fix the page by simply typing in "mainpage" (without quote marks) for both fields at the end of the edit view for each main page affected.

Home Page

Your website's landing page is your home page, which is a special kind of main page - the only difference to other main pages is that you can't delete it or create new ones. This makes sense as your home page's url always should be "index.extension" which will be hidden by default by browsers, so your website visitors can reach your main page without any extension following your domain name (unlike subpages).

referric cms viewreferric cms header selection
You can still do all the other things that you can do with other main pages, even rename the page to something else to show in the menu - since it doesn't affect the url of the page, you wont need to delete the page and create a new one with a new name to match the url with the page title, which you have to do for other main pages for consistency. The edit view of the Home page looks and behaves the same way as other main pages edit views.

Settings and Translations

The settings and translations section in the CMS combines all the options you can set globally for the website.

referric cms viewreferric cms header selection
Settings Global settings of the website that includes a few very important settings that you need to update once you have access to the CMS. The crucial ones are the following: - Site URL: this will feed information into your Sitemap XML file about each page, so if you dont update this with your website's actual URL, than your sitemap will include the default "https://www.mysite.com" as your website (therefore making your sitemap obsolete). - Website language shortcode: this field needs to be updated if you use a language for your website other than english. You can find a list of language codes here. There are a few other global site settings you may or may not want to change, these are the following: - Max number of casinos to show on main pages: this setting limits the casino review lists' length on each main page. This setting comes in handy if you don't plan to show too many casinos on each page, or want to show more than the default. - Website Schema JSON code: this is a global JSON tag that will show on all pages of the website. Website JSON includes basic information about the company running the website. See below example:
    "@context": "http://schema.org",
    "@type": "WebPage",
    "name": "Name of the website",
    "description": "A description of the website goes here",
    "publisher": {
        "@type": "ProfilePage",
        "name": "Name of the publisher"
We have also included an optional cookie consent popup here, which you shouldn't use, unless you plan to include third party cookies on you new site. The website works well without cookies, so unless it is really necessary, we recommend not to use any services that require cookies to be set for the site. Translations If your affiliate website's language is something other than English, you have access to all the areas of the site here that are considered "static" content. This category includes the following: call to action button's text, category descriptions eg. "Welcome Bonus", "Licenses", "Min Deposit" as well as contents of the pages footer, 404 page message, confirmation text when someone sends an email from the website, and even more. You can translate the whole website to any language (that writes from left to right direction). All the fields in the settings window marked with " - Translation" refer to an area of the website that is going to be either translated to another langunage, or rephrased if you would like to write something else in specific areas of the website. These fields are the following broken down to page categories: Appears on all pages: - Welcome Bonus (appears in multiple areas of pages) - Licenses (appears on the back side of casino review cards as well as review pages) - Min Deposit (same as above) - Min Withdrawal (same as above) - CTA Button (appears in many areas of the pages) - T&C Text (appears next to CTAs) - Table of Contents (appears in dropdowns where you can select a topic to scroll to) - Frequently Asked Questions (appears at the bottom of the pages before the footer as the FAQ title) - About Us (appears as Page title in footer) - Contact Us (appears as Page title in footer) - Privacy Policy (appears as Page title in footer) - Responsible Gaming (appears as Page title in footer) Appears on main pages: - Casino of the Month (appears in the Casino of the Month section of main pages as the title of the section) - Review (appears on the back side of the review cards that links to the review page of the given casino) - All Casinos (appears as a link to list all of the casinos of the site, after the reviews list) - Announcement - Optional field, will show a message on the top of the page if this field contains any text. To remove it, clear its contents and save changes. Appears on review pages: - Established (appears in the info table view of the page at the top) - No of Games (appears in the top section of the page) - Wagering (appears in the top section of the page) - Bonus Code (appears in the top section of the page if the casino has a bonus code - this can be set from its review page edit mode, if not this section is set to hidden) - Game Categories (appears as section title after the short introduction text) - Game Providers (appears as section title after the short introduction text) - Payment Methods (appears as section title after the short introduction text) Individual fields: - 404 Page fields - Back to previous page (appears on "All Casinos" page after the list) - Message sent text


The compliance section of the CMS contains a list of organization logos that you can add to all of your pages' footer section. To add one or more you have to enter each logo's edit page and swith them on or off one by one (you can do that by toggling the "Visible in footer" switch).

referric cms viewreferric cms header selection
If you are looking for the compliance text (also found in the footer of your pages) to edit, you can find that in the "Settings and Translations" section of the CMS. We have added an extensive list of organization logos that you can choose from, in case you are missing a few please let us know and we will add them for you. You can also add it yourself if you wish to, just follow the guide found on this page in the Advanced Tips section below. If you open the edit view of a logo found in this section you will see a few options available for you to change. Visible in Footer: Switched on means the logo will show up on your pages, switched off will hide this specific logo. Title: This is the title of the images (shows in the CMS so you can easily recognise which logo you are editing) Page Link: The URL where the logo links to. You have two options: internal link or external link. External links require full URL (including https://) Links to Inner Page: If the logo you are editing needs to link to an inner page of the website you should switch this toggle on. If this switch is left off, your inner page URL wont work. URL Relationships: Add or remove html tags that describe the link. You might be familiar with a few, but here is a list of what each means: - sponsored: paid link content - external: links to a page outside of the website - nofollow: url links to an unendorsed page - eg. paid link - noopener: requires that browsing context created by clicking the link mustn't have an opener tag - noreferrer: hides the referrer (makes it unknown) - noindex: tells search engines not to index the page SVG Viewbox: The coordinates of the four points of the rectangle that the svg path will show in SVG Path The svg path's coordinates, each point is represented by a numeric value

Using Images on Pages

Traditional CMS will offer you a simple image upload directly into the section where you'd like the image to be visible, our solution is a bit different but with its benefits. Let us explain why. Referric is built on a headless CMS engine, this comes with certain changes compared to traditional solutions such as WordPress. The benefits is a fully be-spoke white label solution that is tailored for iGaming. Due to this, adding images needs to be done via the examples below. We promise you it won't take long and it will only benefit your ranks in the long run. You can find examples below of how you can add images to some sections of your pages. The code example fits well in the guide sections of the main pages or reviews sections of the review pages. You can simply paste the code below in the text box in one of these sections, and the image should appear on the page. If you have basic HTML knowledge you can also add images to other sections of the site as well if you wish to. A convenient way to add images is to upload them through the CMS' media tab in the main view. Since this folder is reserved for casino and sportsbook logos, it is called "/logos/" in the URL - don't forget to include this part when you replace the path with your uploaded images' path. Here is an example of how to link an image uploaded (called "mypicture.jpg" as an example) to your media folder:

<img data-srcset="/logos/mypicture.jpg" style="width:100%;border-radius:var(--cta-border-radius);">
You can remove the "border-radius:var(--cta-border-radius);" part of the HTML code if you want your images to ignore the corner rounding that is set for most of the panels of your pages. Pro tip: To avoid reaching your monthly hosting traffic limit (100GB/month), we recommend uploading images to a free image hosting website and linking images from there. This method will make your visitors download the images from a different hosting platform and therefore won't affect your monthly traffic quota. To do this, use the following Html code somewhere on your page and replace the URL with the one from the image hosting.
<img data-srcset="https://ibb.co/F8zLBqZ" style="width:100%;border-radius:var(--cta-border-radius);">
Here are a few free image hosting websites: imgbb, postimages or free image host.

Advanced Tips

Adding Custom Compliance Logos The edit view of a new compliance logo might look scary at first glance, but its actually not complicated to add a new logo at all. What you will need: - A flattened SVG file of the logo (containing only one path that draws the whole logo). An svg image is a multi purpose format which both works as a vector graphic and as html code. We will need the Html code to be able to add the appropriate snippets to their corresponding fields in the logo edit window of the CMS. Follow these steps to add a new custom logo: - open the svg image in a text editor so you'll have access to the html code that describes the images - find the html attribute called "viewbox". You will see some coordinates that is crucial for the svg image to show up on the page in the right sizes - copy the inside content of the viewbox attribute, it will look something like this:

0 120.3 10 32.5
- paste the copied code to the viewbox field - copy the svg path to the "svg path" field. This can be a very long list of numbers, letters, dashes, full stops and commas combined, so make sure that you copy it from quote mark to quote mark. Here is an example:
M39.9,2.5L21.4,6.3C21.2,6.4,21,6.7,21,6.9l0.4,0.5,0.4l13.1-2.8l0,17.1L7.2,20.9c-0.1,0-0.2-0.2-0.2-0.3v-5.2c0-0.1,0.1-0.3,0.2-0.3l5.7-1.2c0.1,0,0.1,0,0.1,0.1v5.5c0,0.2,0.1,0.3,0.3,0.3l5.1,1.1 c0.2,0,0.3-0.1,0.3-0.3l0-13.2c0-0.3-0.3-0.6-0.6-0.5L2,10.4c-0.5,0.1-0.8,0.5-0.8,1v13.4c0,0.5,0.3,0.9,0.8,1l37.9,7.8 c0.2,0,0.3-0.1,0.3-0.3l0-30.6C40.2,2.5,40.1,2.4,39.9,2.5z
If you want the logo to link to a page on the website you need to toggle the "Links to inner page" toggle (eg. /responsible-gaming/). In case the logo links to outside of the website you can simply add the url of the page it links to with its "https://" part included. Search Console In case you would like to add your website to Google Search Console you have the following options available that will work ("yoursite.com" represents your custom domain name):
To verify site ownership for search console: 1. Add new property in Google Search Console 2. Select property type "URL prefix" 3. Select the second option "HTML tag" 4. Copy the code snippet 5. Open up the CMS of your website, select "Home page" and enter edit mode 6. Paste the code snippet into the "Geo Tags and Third Party Links" box and save changes 7. Go back to search console and verify website Cookieless Google Analytics The future of the internet is cookieless. Google and other big tech companies also realised this in the recent years, and to comply with new trends they have released options for Google Analytics to run without using cookies that would require a cookie consent on your website to be compliant with regulations. Your new website works without cookies, and to keep it that way if you wish to use an analytics tool you should also use one that supports this architecture and runs without the need to use cookies. The basic idea is to tell Analytics to no store anything client-side. You can do this with the following modification to the gtag:
gtag('config', TRACKING_ID, { client_storage: 'none', anonymize_ip: true })
For further resources about how to set up a cookieless Google Analytics you can read this guide or check out this github repository. You might be better of with an alternative solution that was built with cookieless in mind, so beside Google's analytics solution there are also several other options available for you to use, you can find a list of these here. Cookieless Hotjar There is no way to set up Hotjar as a cookieless service (as of today). If you want your site be compliant with regulations, avoid using Hotjar for now. We will post an update here - along with a setup guide - if the situation changes. Cookie Notice Popup Many third party links use cookies, which is unfortunate, but if you still would like to use some, you can set a cookie consent in the settings/translations section. We have included two fields where you can add some text to the consent, as well as a field for a custom text for the consent button of the popup.

V 1.04

search icon

Get Started