Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,059 of 9,059 pages
About the help in other languages
All help pages

When the target lacks some content

--unmapped=drop|keep|fail decides what happens to references to content the target does not have (default drop).

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/build-two-ways/examples/migrate/missing-content-on-target.md

On this page

When the target lacks some content

Know what happens to a hand-picked article that does not exist on the target.

Life cycle: Migrate, example 4 of 34. Worked out on the Fit & Healthy site of Exponential 6.0.15+.

Contents

  1. In the Layouts editor
  2. On the command line
  3. Which to choose
  4. Check

In the Layouts editor

  1. After an import with drop, check hand-picked lists for gaps.

On the command line

  1. --unmapped=fail stops the import and shows what is missing; drop (default) leaves those items out; keep keeps the reference as it is.
  2. ./console exp:layouts import layouts.zip --dry-run --unmapped=fail and read the States (new, identical, changed, conflicting).
  3. Run it again without --dry-run, with the --strategy you chose and --publish if the result should be live at once.
  4. Nothing to clear by hand: since explayouts_core 1.0.10 an import with --publish purges the page cache itself.

Which to choose

fail first, to see the list; then import the content or choose drop.

Check

  • Manual collections have the expected items.

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.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x