RandomBackground sets a background from a defined list randomly when you re-load (or load) a page on the wiki.


Add the script to your w:Special:MyPage/global.js (if you want a random background on all Wikia-hosted wikis) or Special:MyPage/wikia.js (for a specific wiki). Also, you can add this to MediaWiki:Wikia.js (for site-wide):

    type: 'script',
    articles: [
importArticles — Best Practices for installing JavaScript on FANDOM

The importArticles statement is designed to combine multiple HTTP requests into a single data transfer, allowing multiple scripts to load and execute faster. If you've been installing several different scripts, your JavaScript file has probably accumulated unnecessary import statements. Click "Expand" to learn how to efficiently batch import scripts to speed up performance and make your code look cleaner. One other approach is by using the MediaWiki:ImportJS.

If your JavaScript file has several lines of code that say importScript, importScriptPage, or importArticles, you may be able to combine them! By batch importing a collection of scripts with a single import, your JavaScript code will load faster and look cleaner. Consider the example below. On the left is an example of what your JavaScript file might currently look like. On the right is how you could improve that code.

Multiple imports — messy and slow One import — clean and efficient
  type: 'script',
  article: 'u:dev:FloatingToc/code.js'
importScriptPage('page1.js', 'wikiname');
importScriptPage('page2.js', 'wikiname');
  type: 'script',
  articles: [

Note: In this example, pay close attention to the placement of commas and other punctuation. For people who aren't familiar with programming (and even those who are!), a common mistake when writing code is to accidentally delete, forget, or misplace critical symbols like commas or quotation marks. This can cause a syntax error that breaks the code. Carefully follow the convention shown here when using importArticles.

But there's much more to importArticles than just this! For more examples and advanced usage, see the help page at Help:Including additional JavaScript and CSS.


This script needs a list of backgrounds (url) to set in your wiki. For this, you just must declare a list before of script import.

var bgrandom_list = ["bg.png","bg2.png","bg3.png"];

You can also enable night mode and day mode.

var bgrandom_nightmode = true,
    bgrandom_nightmode_list = ["bg-night.png", "bg-night2.png", "bg-night3.png"];
Additional configurations

By default, backgrounds are show with a default code CSS, if you want configure this there are several extra options:

Option Description Default
bg_color Set a default color for the background on the site. #000
bg_size Set a size for the background. cover
bg_attachment Set the attachment for the background. fixed
bg_repeat Set the background if it repeat or not. no-repeat

Here's a example:

var bg_color = '#fff',
    bg_size = '95%',
    bg_attachment = 'scroll',
    bg_repeat = 'repeat';

Using configuration options with FANDOM Open Source Library scripts
The instructions on this page describe how to use configuration options with a script. Here on the FANDOM Open Source Library, many scripts provide optional configuration settings as a mean to alter or enhance the default behavior of the script. When installing configuration options in your JavaScript file, please note that they need to go above the import statement in order to work — unless the directions say otherwise. In case MediaWiki:ImportJS is used to load the scripts, it will be executed last.
Configuration options load too late, don't work
Proper placement of configuration options
// 1. AjaxRC import statement
// 2. AjaxRC configuration option
var ajaxRefresh = 30000;
// 1. AjaxRC configuration option
var ajaxRefresh = 30000;
// 2. AjaxRC import statement