Configuring Image Assist in Drupal 6

Image Assist is a great choice for adding images to content in Drupal. This module allows users to upload and insert inline images into posts. It automatically generates an Add image link under the textarea fields of your choice. In this post I will go throught the initial setup of this module, saving usage for a later post.

For a good discussion on multiple ways of importing images into your drupal site and each approaches pros and cons, please see: .

  1. Check your Status Report

    You should have a clear status report (Administer > Reports > Status report) before continuing with these installation instructions. Specifically, you must be confirmed on both File system and Image toolkit.

  2. Download Modules

    Image assist depends on Image and Views modules to work. Make sure that you get the latest versions of these three modules:

    Image -
    Image Assist -
    Views -

    Once you have downloaded the modules, move them to the appropriate modules folder for your install and extract them in place.

  3. Enable Modules

    From the Modules page (Administer > Site building > Modules), enable Image, Image Assist, and Views. As a site administrator, run update.php. You will be told that directories have been created for images.

  4. Configure Permissions

    The following permissions can be assigned to certain roles on your site:

    image module: create images; edit images; edit own images; view original images
    img_assist module: access advanced options; access all images; access img_assist; use original size

    I would suggest only allowing trusted people to upload images, until you are very confident in the security & stability of your setup.

  5. Configure Image Module

    Configure the Image module (Administer > Site configuration > Images) to set some of the default bit and aspect sizes. From this page you can set the maximum upload size and the default directory for uploads. Additionally, image sizes can be set for the three default image sizes (Original, Preview, Thumbnail) and the resizing operation can be chosen from scale or scale and crop. The Scale image operation resizes images so that they fit with in the given dimensions. If only one dimension is specified the other dimension will be computed based on the image's aspect ratio. The Scale and crop image operation resizes images to be exactly the given dimensions. If only one dimension is specified the image will not be cropped, making this is equivalent to Scale image. Additional image sizes can be defined on this page.

  6. Configure Image Content Type

    I would suggest making a few changes to the default settings given the automatically created Image content type (Administer > Content management > Image) based on your sites needs. Under Submission Form Settings, empty the text from the Body field label to remove the body field entirely, or optionally relable the body field to something such as Image Description. If you do not wish to have each image be viewed as an individual node, turn off the Published and Promoted to front page options.

  7. Configure Image Assist Module

    There are alot of configuration settings for Image Assist (Administer > Site configuration > Image Assist). I would suggest carefully reading the helpful descriptions below each setting and to try to tighten the settings up as much as possible to restrict access to the image assist dialogue. I will go through these setting as group at a time.

    Access settings

    We want to limit the pages Image Assist will be available on by setting 'Display Image assist on paths' to 'on specific paths', then defining the paths in the text-area below. The default paths will restrict Image Assist to the node and comment pages.

    We also want to limit which text-areas the link to Image Assist will appear on by setting 'Display Image assist on text areas' to 'Show on only the listed textareas.', then defining the ids in the text-area below. The default ids will restrict Image Assist to the node and comment text-areas.

    Image generation settings

    Make sure that the maximum image size is set high enough for your needs, but no higher. Under 'Creation of image derivatives', turn off Allow all users to create custom size inline images.

    Image property dialog settings

    These settings are all about filling in the defaults on the Image Assist window. I would suggest the following setup. Set the 'default insert mode' to 'Filter Tag' and I would suggest also setting the default caption title and text to 'disabled'.

    Image display settings

    You will most certainly want to style your images to match your site and will have the best luck at this by setting this option to 'No' and following the instructions below this to copy the proper style elements into your main css file. Basically you sre going to open the file css file included in the image attach module folder and copy the last few declerations into your themes stylesheet.

  8. Create New Input Filter

    To use the Filter Tag (my suggestion), you will need to modify your Input Filters so that the inserted tag will be parsed. Add a new Input Filter (Administer > Content configuration > Input formats). Give your new filter a descriptive name such as 'Filtered w/ Image' and then choose which roles can use this new filter. Finally, turn on 'Inline images' and all is set.

Thanks for reading and I hope this gets you started on the right foot with Image Assist.


Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.

Why do we need Views Module

Why do we need Views Module with ImageAssist?

The views module is used to

The views module is used to display the thumbnails in the 'Choose an image' dialogue.

This is the only article that

This is the only article that has successfully taught me how to do this. Keep up the good work.

Curious as to how to override

Curious as to how to override the output for teasers, say you float an image right in a node, and would like the thumbnail size of the same image to appear in the teaser. Unfortunately, Image Assist seems to add height and width to a picture which only makes this more complex... :-(

Some themes, such as Garland,

Some themes, such as Garland, allow you to manipulate the teaser field separately from the body field. I have used this to create a small thumb to go with the teaser, but then include the same text, but with a bigger image into body. For an example, look at:, where the post labeled: Czech Lesson 2.1 - Locative Case, has differing sized images on the teaser and in the body.

This post is very helpful but

This post is very helpful but the problem I'm having is when I try attaching an image to a page with Image Assist, all that is displayed is the html code and not the image. i have all the necessary modules enabled, im using the input filter and it still isnt working. does anybody know why this might be? thank you.

When you finally add the

When you finally add the image in via the dialog box, make sure to choose 'Filter Tag' and not 'HTML code'.

ImageField Assist is showing

ImageField Assist is showing less than 400 sites using it in usage statistics, whereas ImageAssist has nearly 20,000. I think it's safe to say that some project like ImageField Assist will grow into something full-fledged, but for the moment, it doesn't seem to have enough users to have "really stable" status, it's more for bleeding-edge users.

I'm surprised that you have

I'm surprised that you have opted for Image and Image Assist rather than Image Field and Image Field Assist.

The latter (in my opinion) is a lot more powerful, especially with regards to resizing images according to the type of your post.

I have tried alot of image

I have tried alot of image solutions and find that now IMCE rocks the boat for anything that an administrator needs. But that most end user cases, I push for just using Image Field so all the styling and placement is up to the designer. I am going to give ImageField Assist a shot because the despription has a nice sound to it:
This module can use every single ImageField field added to any node in a Drupal 6 website, and uses ImageCache presets to display it. ImageField Assist is based on img_assist code.

Post new comment

  • Allowed HTML tags: <em> <strong>
  • Lines and paragraphs break automatically.

More information about formatting options

Enter the characters shown in the image.