Enter or change the following information as needed:
Name: Defines the file name. Use a descriptive name that makes the image easy to find.
Description: Describes the image. A description is particularly useful for photos or infographics when the file name does not adequately describe the content.
Categories: Assigns categories to the image.
Select Save.
The image is uploaded to the wiki. If the image already exists: An error message is displayed. Upload a new version of the existing image from its file version page, or use a different file name to upload the image as a separate file.
Note:When uploading a new file, you should check the file/page name for unusual special characters (e.g., ", %, /,< ,>, [ ,], {, }). Change the name to include only standard characters, since the server file system could have problems with them or since some characters have special meanings in MediaWiki.
The special characters (, ), &, + can be used and are translated into their equivalent%-hex notation.
: will be converted to spaces, unless it is part of an existing namespace prefix.
Search for an existing image
Instead of uploading a new image, select an image that is already stored in the wiki.
Search: Displays recently uploaded images. Enter a search term to search available files in the current wiki and in the Shared resources wiki. The best matches are displayed first.
Advanced search: Provides additional search options and filters for finding images.
Configure image settings
Image settings are divided into General settings and Advanced settings.
The general settings define the image caption, alternative text, and other descriptive information.
Caption: Displays a caption with framed images and thumbnails. If an image is changed from frameless to framed, enter the caption again.
Alternate text: Provides a text alternative for the image. Alternative text is used when the image cannot be displayed and by screen readers. Enter descriptive alternative text that conveys the relevant information provided by the image.
Advanced settings
The advanced settings define the image position, image type, border, and size.The following settings are possible:
Displays the image with a frame and caption. The default width is 300 px. The width can be adjusted. A preview icon indicates that the image can be opened at a larger size.
Displays the image without a frame. The image is displayed at full width and can be resized.
By default, images are inserted without text wrapping and are centered.
Images inserted by VisualEditor normally link to the Media Viewer. To remove this link, edit the image tag in source editing mode and add an empty link attribute:
frameless picture with link (standard): [[File:adult-chair-company-380769.jpg|frameless]]
frameless picture without link: [[File:adult-chair-company-380769.jpg|frameless|link=]]
Border: Enable or disable the image border.
Image size: The Image size setting provides the following options:
Standard: Sets the image width to 300 px unless a different standard width is defined in User preferences.
Custom: Sets a custom image width.
Make full size: Resets the image to its original dimensions.
An image cannot be set to a larger dimension than the actual image dimension.
Insert an image using drag and drop
An image can be uploaded and inserted by dragging the file directly from the local file system onto the page in VisualEditor.
Wait until a horizontal line inidcates the insertion position.
Drop the image.
If the horizontal insertion line is not displayed, the image is not uploaded or inserted.
Configure drag-and-drop settings
The default image settings for images inserted by drag and drop can be configured in the Config Manager.
Store images in a wiki
Images are stored in the wiki where they are uploaded. Images uploaded to a subwiki are available within that wiki according to the applicable access permissions.
Images that should be available across wikis can be stored in the Shared resources wiki. Files stored there are available through the file search.
Change an embedded image
An embedded image can be replaced with a different image or updated with a new version of the same image.
Replace an image
Use Change image to replace an embedded image with another image.
Replace an embedded image:
Open the page in edit mode.
Double-click the image.
Select Change image.
Select a different image.
Save the page.
Upload a new version of an image
When an existing image has been updated, upload the new version to the file page. For example, upload a new version when an organization chart changes. Upload a new version of an image:
Open the file page of the image.
Select Upload a new version of this file. The page Special:Enhanced_upload opens.
Select the updated image file or drag it onto the upload area.
Complete the upload.
The new version replaces the previous version of the image. The version history remains available on the file page. By default, pages that contain the image automatically display the new version.
Display images as a gallery
Images can also be displayed in gallery format on a page. You can find the documentation for this at Mediawiki.org
