Troubleshooting

The Package Does Not Appear for Installation

• Confirm that the directory is /packages/hero_image_plus.
• Confirm that controller.php is directly inside that directory.
• Confirm that the ZIP did not create an additional nested folder.
• Clear the Concrete CMS cache.
• Check the PHP error log.

The Block Does Not Appear

• Confirm that the package installation completed successfully.
• Open Dashboard > Extend Concrete and run any available update.
• Clear the cache.
• Verify that the current user may add the block type to the selected area.

Drag and Drop Does Not Work

• Confirm that version 1.0.1 or newer is installed.
• Clear the Concrete CMS cache and browser cache.
• Reload the edit dialog.
• Check the browser console for JavaScript errors.
• Confirm that the Concrete CMS jQuery UI asset is available.
• Use the move-up and move-down buttons as an alternative.

An Element Cannot Be Dropped into a Group

• Groups accept normal content elements.
• Groups cannot contain another group.
• Drop onto the group's child area, including the empty-group drop zone.
• Clear cached JavaScript after an update.

The Background Image Looks Cropped

The background uses background-size: cover.

Cropping is expected when the image aspect ratio does not match the hero area.

Adjust:

• Horizontal background position
• Vertical background position
• Hero height
• Source image dimensions
• Separate mobile background image

High Parallax Strength Produces Little Movement

The configured value is a maximum request.

Actual movement is limited to the vertical image overflow available without exposing empty areas.

Use a taller source image or a shorter hero when stronger movement is required.

The Navigation Is Not Transparent

• Confirm that the navigation block supports the Concrete transparency marker.
• Enable transparency in the navigation block.
• Place the hero as the leading page element.
• Check for an intervening container or block.
• Clear the cache.
• Test with Atomik to isolate custom-theme behavior.

The Content Is Too Close to the Edge

Increase Horizontal content spacing.

A value of 0 uses the responsive default. Custom values move left- or right-aligned content farther inward.

Text Is Difficult to Read

Use one or both overlay modes:

• Full-background overlay
• Content-only overlay

Adjust color and opacity and verify contrast on desktop and mobile.

The SVG Cannot Be Cropped

SVG cropping is intentionally disabled.

Use width and height controls, edit the SVG viewBox externally, or use a raster file when crop processing is required.

The Hover Image Does Not Change

The hover swap requires two non-SVG images.

Confirm that:

• A hover image is selected
• Both files are raster images
• No JavaScript error is present
• The pointer device supports hover

The Mobile Image Is Not Used

The mobile image is applied below 768 pixels.

• Confirm that a mobile image is selected
• Test below the breakpoint
• Clear CSS and page cache
• Check whether custom theme CSS overrides the background

Custom Colors Do Not Render

Use a valid HEX, RGB, or RGBA value.

Examples:

• #6f42c1
• rgb(111, 66, 193)
• rgba(111, 66, 193, 0.8)

Invalid values are rejected or normalized.