INTEREST JOURNAL DRUPAL & WEB

Drupal Guide in Detail: 11.6 Placing Custom Module and Theme Files

About 400 words 2 min read

Japanese ↗
On this page

Detailed guide. An unofficial adaptation of User Guide 11.6. Source updated April 14, 2025; reviewed November 6, 2026. No running-Drupal procedure test has been performed.

Official source ↗ · Previous: 11.5 Installing and Selecting a Contributed Theme · Chapter 11 overview · Next: 11.7 Understanding Development and Production Sites

Scope

Use manual placement for custom or supplied extensions unavailable through Composer. Manage core and Drupal.org packages through Composer as in 11.3 and 11.5 , keeping ownership of files clear.

Adapted file-placement workflow

Identify Drupal’s document root, commonly web in recommended-project. Place modules under modules and themes under themes; custom and contrib subdirectories distinguish origins.

For a custom-code replacement, prepare maintenance mode and recoverable originals. The source replaces the complete old directory before unpacking the new files. Confirm the exact extension scope first. Its extraction example is:

tar -xzf custom_toolbar-2.4.0.tar.gz

Check the extracted directory structure, remove leftover distribution archives from public storage, and continue with Drupal installation or update procedures. Keep files consistent across environments.

Our verification examples

Replacing files is not uninstalling a module. Uninstallation can remove configuration and data. Check provenance, compatibility, dependencies, nested directories and missing files. No files were transferred, removed or extracted while writing this page.

Sources, credits and changes

Source: Drupal User Guide 11.6 ↗ . Contributors and source links listed in its Attributions: Boris Doesborg ↗ · Jennifer Hodgdon ↗ · Marc Isaacson ↗ · Joe Shindelar ↗ · Drupalize.Me . Refer to the source for writing, editing and adaptation roles, and to the guide-wide credits ↗ .

Copyright remains with the individual contributors; the official copyright page ↗ states © 2015–2025. Changes include reorganized explanations and procedures, our preparation and verification examples, troubleshooting notes, source-interpretation qualifications and release references. Original screenshots and videos are not reproduced. This adapted text is shared under CC BY-SA 2.0 . It is not an official edition or endorsement. This notice does not license unrelated articles or the site design.

Previous: 11.5 Installing and Selecting a Contributed Theme · Chapter 11 overview · Next: 11.7 Understanding Development and Production Sites

Chapter 10 details · Chapter 12 · All chapters · Search official information

Back to chapter contents ↗