Customization policy

The following is the full Customization Policy regarding the customization of wikis on the wiki.gg platform using files, css, js, or other other methods of changing the appearance or display of the wiki and its contents.

If something is not covered in this policy, or you have questions concerning it or other customization questions, please reach out to wiki.gg staff.

Assets

• You must have a logo uploaded with the file name :File:Site-logo.png
• You must have a favicon uploaded with the file name :File:Site-favicon.ico
• If you have a background image uploaded, it must be at most 1MB in size, under 500KB is highly recommended (using .jpg file format and compressing with either https://tinypng.com/ or https://squoosh.app/ is recommended)
• Files used in CSS must be uploaded locally and not point to external sites. Linking to files on other wiki.gg wikis is permitted where it makes sense for the styles to be synced, such as wikis covering the same topic in different languages. External links are allowed only where it's not otherwise possible, such as for Discord widgets where the banner image regularly updates.

Colors & accessibility

• Do not add a custom cursor to your wiki. Custom cursors are prohibited. There are no exceptions to this rule.
• Custom fonts are allowed, but you must pick a legible font. What constitutes a legible font is decided by wiki.gg staff.
  • Page titles (h1) have a bit more flexibility than body text since they are displayed in a bigger font size.
  • You may also include additional themes beyond the default light/dark that have more "fun" fonts, for example if you wanted to create a "terminal" theme then a monospace font would be fine. You can add themes at MediaWiki:Theme-definitions .
• You must include a link to Recent changes in your sidebar. Do this using the text * recentchanges-url|recentchanges. These strings will automatically be translated by the software, and they'll provide the hotkey Alt/Opt+Shift+R to navigate to Recent changes from any other page on the wiki.
  • If you want to change the text display, you may edit the page MediaWiki:recentchanges.
  • more info about recentchanges
• Text elements must have enough contrast with their background to be easily legible. If your wiki has multiple themes, this applies to all of them.
  • Inline color styling is discouraged because it makes it difficult to maintain this contrast on multiple themes.
  • If your wiki is using an up-to-date version of the default loadout, Mediawiki:common.css/doc can help with this.
  • You can use a contrast checker to check your contrast levels, or a contrast finder to help you pick new colors. Please meet at least AA standard.

Animated & moving content

Avoid excessive or repeating animations, especially on the main page. In particular, the following are discouraged:

• Animated gifs as a background image, border image, or other decorative asset
• Automatically-advancing slideshow galleries

The following are permitted:

• Including gifs that are important game assets on a character or other subject page, but it is recommended that they be in a gallery near the bottom of the page
• Spinners that display temporarily to indicate that something is loading
• Indicator movement on user-initiated state change

Links

• Your links must be easily distinguishable from regular text.
• Regular links may not be red or similar colors. Red is reserved for links to pages that don't exist (aka "redlinks").
  • Links to pages that don't exist ("redlinks") must be red.
• Using the same color for links as for regular text is allowed if you use an underline for your links.

wiki.gg

• Don't alter the appearance of the wiki.gg header or footer in any way without first getting approval from wiki.gg staff.
  • If another wiki has made a change to one of these with approval, you may copy this change without permission; however, you may not make any alterations. If you want to make alterations, you must get approval from staff.
  • You are responsible for ensuring that your own wiki is approved!
• Don't alter the display or appearance of advertisements in any way.
• Don't hide/edit the content or appearance of content licensing in the wiki footer, file licensing templates, or other legal notices, without staff permission. EXCEPTION: Moving the content license image in the wiki footer to be adjacent to the MediaWiki logo is pre-approved.

Personal styles

Custom styles created by editing Special:MyPage/common.css are only visible to yourself. Thus, on this personalized page, there are no rules, since they will affect no one other than yourself.

Gadgets

Main article: Gadgets

Gadgets that are opt-in (not marked as default) have reduced restrictions. They may ignore rules from the #Colors & accessibility section above, but not the #wiki.gg section. This is the recommended approach if you really want say, a custom cursor or a discouraged feature.

Additional accessibility concerns

Requirements listed here may be more difficult to adhere to than the requirements in other sections if you are customizing your theme significantly. Therefore, we are issuing them as strong recommendations; we do not permit deliberately violating them, but please don't feel too much stress about adhering to them either.

If you think you have to violate one of these accessibility guidelines to make your theme work, please ask wiki.gg staff for help!

• Font sizes must be in units of rem or em. Do not use pixel values for fonts. This especially holds in body text.
• Consider mobile responsiveness when designing all aspects of the site, including:
  • The main page
  • Images (our default loadout has a responsive-image class you can apply to wide images)
  • Tables, especially wide tables
  • Templates