Contents
- Three ways, one result
- Upload to the media library
- Upload while editing an article
- Put a picture inside the text
- Writing the alternative text
- If it does not work
Three ways, one result
Every picture you upload becomes an item of its own, of the type Image, with a title and an alternative text (Images, media and uploads). You upload it once and can then use it in as many places as you like. The site makes the smaller copies it needs for lists and pages by itself, so you never resize a picture for each place (Image variations).
Upload to the media library
Best for pictures you will reuse, or many pictures at once.
- Click Media, or Upload files in the dashboard's quick actions.
- Check the Target location (for example Images). Quick locations offers the usual places.
- Press Choose files..., or drag the pictures onto the dashed area.
- In the queue, check each title and fill in the alternative text where the site asks for it.
- Press Upload all.
(Upload files has every option, including uploading a whole ZIP file.)
Upload while editing an article
Best for the one picture that belongs to one article.
- Edit the article.
- In its Image field, press Upload new (or Upload a file) and choose the picture from your computer.
- Fill in the alternative text when asked.
- Press Send for publishing.
To use a picture that is already on the site, press Add existing instead and pick it (Relations and images).
Put a picture inside the text
- Edit the item and click into the text where the picture should go.
- Press Insert/edit image in the toolbar.
- Upload a new picture (with a name and alternative text) or find one that is already there.
- Choose a size (small, medium, large) and an alignment.
- Press Insert, then Send for publishing.
(How do I insert an image in the online editor?)
Writing the alternative text
The alternative text is read aloud to people who cannot see the picture, and shown when the picture cannot load. Many sites require it.
| Picture | Weak | Better |
|---|---|---|
| A photo of the shop front | "image1" | "Our shop on Main Street with the blue awning" |
| A chart | "chart" | "Visitors doubled between May and June" |
| A team photo | "team" | "The five volunteers of the summer fair, smiling at the camera" |
Describe what matters in the picture in one sentence. Do not start with "picture of".
If it does not work
| What you see | What to do |
|---|---|
| The upload is refused as too large | The page shows the largest file it accepts. Make the picture smaller on your computer first (a photo for the web rarely needs more than 2000 pixels wide) |
| The type is not allowed | Use JPEG, PNG or WebP (When an upload fails) |
| No permission there | Upload into another folder, or ask your administrator |
| The picture looks huge on the page | Choose a smaller size in the image dialog rather than uploading a smaller file |
Only use pictures you are allowed to use: your own, or ones whose license allows it. Ask before publishing photos of recognizable people.
Related pages
- First steps
- Images, media and uploads
- Image and file guidelines
- Free documentation: this page is free to copy, translate and improve under the GNU FDL 1.3.
Become an Exponential Partner. Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster. Start with Partners: start here and How to apply.