1. Go to Settings -> Fields.
2. Click New field.
3. Enter a name such as Entry Mapper.
4. Use a handle such as entryMapperField.
5. Choose Image Markers [Super Image Markers] as the field type.
6. Configure source restrictions and upload behavior if needed.
7. Save the field.

After creating the field, add it to the field layout for the element type where editors need it.

Common examples:

• Entry type for an interactive floor plan.
• Entry type for a product lookbook.
• Entry type for a venue map.
• Entry type for a staff or team photo.
• Category group for location diagrams.
• Global set for site-wide maps or shared diagrams.

Use Allowed asset sources to limit which asset volumes editors can choose images from.

Leave the setting blank to allow images from all asset sources.

Use source restrictions when:

• Only one image volume should be used for mapped images.
• Editors should not pick from private or system asset volumes.
• The project has separate volumes for documents, downloads, and images.

The selector still restricts choices to image assets.

Use the upload settings when editors should be able to upload a new image without leaving the field:

• Default upload location source chooses the asset volume used by the upload button.
• Default upload location subpath optionally places uploads in a folder path, including Craft-supported dynamic subpaths.
• Allow uploads controls whether the upload button is available in the native asset selector.

Uploads also depend on the current user's Craft asset permissions. If a user cannot save assets in the selected volume, the upload action will not be available to them.

Use Allowed entry sources to limit which entries markers can link to.

Leave the setting blank to allow entries from all entry sources.

Use source restrictions when:

• Markers should link only to products.
• Markers should link only to people or team member entries.
• Markers should link only to locations.
• Editors should not accidentally choose entries from unrelated sections.

Choose a handle that describes what the mapped image represents:

• entryMapperField
• imageMap
• floorPlan
• productMarkers
• locationMap
• lookbookMarkers

The field validates that:

• The selected image ID resolves to a Craft asset.
• The selected asset is an image.
• Marker entry IDs resolve to valid entries.
• Markers are not saved without an image.

Coordinate values are normalized before saving, so invalid values are clamped into the 0 to 100 range.

Marker colors are normalized to valid six-character hex values. Invalid colors fall back to the default marker color.