Are you viewing the right article?

This article refers to Digital Publishing Suite. For the AEM Mobile article, see Manage articles.

You can create articles that are either based on InDesign documents or HTML files. There are two ways to add articles to a folio: use the Add Article button to create articles based on open InDesign documents, or import articles from a folder.

Create an article from an open document

Articles can include either one or two layouts for portrait and landscape orientation on the mobile device. However, you must be consistent within the published folio. All articles in the published folio must be portrait only, landscape only, or dual orientation.

Articles view
Articles view

  1. Open the InDesign document that is designed for digital publishing. See Designing digital publications.

    The document dimensions can be different from the folio size in two situations.

    • The aspect ratios of the folio and document page size are identical. For example, you can add 1024x768 documents to a folio that is set to a 2048x1536 folio size because both aspect ratios are 4:3.

    • The document is designed for smooth scrolling. For example, if you create a 1024x2000 document with a single page, the added article should be set to Smooth Scrolling.

  2. In the Folio Builder panel, create or open the folio in which the article will appear.

  3. In the Articles view of the Folio Builder panel, click Add.

  4. Specify the following options, and click OK.

    Article Name

    Specify the article name. The article name does not appear in the viewer. The Article Name is used for creating links between articles, so use a name such as “City_Guide” instead of a filename such as “city_guide_h.indd.” The maximum number of characters for Article Name is 60.

    Article Format

    Specify an image format setting for the article. For example, you can choose PDF for an article to allow pinching and zooming. See Differences Between JPG, PNG, and PDF Image Formats.

    JPEG Quality

    If Automatic or JPG is selected for Image Format, specify the JPEG Quality. Increased quality increases the file size.

    Smooth Scrolling

    Set the Smooth Scrolling for the article, not for just the layout you’re adding. For example, if you’re adding only the vertical layout in a dual-orientation folio, choose Both Directions if both layouts are smooth scrolling. Select Horizontal Only or Vertical Only if it’s a single-orientation article or if only one layout is smooth scrolling.


    When you select a Smooth Scrolling option, you can specify alternate layouts. If your smooth scrolling document has only one layout, choose it for the appropriate layout, and choose None for the other layout that you will add later.

Add a layout to an article

If your InDesign document includes multiple layouts, you can specify both horizontal and vertical layouts when you create the article. You can also add a second layout from a different document. If the article appears in a dual-orientation folio, the article requires a second layout.

  1. Open the InDesign document that is designed in a different layout orientation from the existing article layout.

  2. In the Folio Builder panel, double-click the article to which you want to add the second layout.

  3. In the Articles view of the Folio Builder panel, click Add Layout. If the document includes multiple layouts, specify the appropriate layout.

Import InDesign articles

There are three methods for importing articles:

Single article Import a single article located in the specified folder. The folder should contain either InDesign files or HTML files. InDesign files should include _h or _v suffixes, such as article1_h.indd or article1_v.indd. This method does not support InDesign alternate layouts.

Multiple articles Import a group of articles located in subfolders within the specified folder. This method does not support InDesign alternate layouts. For information on structuring folders, see Structuring folders for importing articles.

Multiple articles using path-based sidecar.xml You can also import articles as defined in a path-based sidecar.xml file you specify. This option is especially useful for InDesign documents with multiple layouts. For details. see Importing articles using path-based sidecar.xml.

When you import articles, the aspect ratio of the articles must match the aspect ratio of the folio unless you select a Smooth Scrolling option.

  1. Create InDesign source documents. Depending on the import method you use, you might need to organize your files in a specific way. See Structuring folders for imported articles.

  2. In the Folio Builder panel, open the folio in which the article or articles will appear.

  3. In the Articles view of the Folio Builder panel, choose Import Article from the panel menu.

  4. Do any of the following:

    • Choose Import A Single Article, click the Location folder icon, and specify an article folder.
    • Choose Import Multiple Articles, click the Location folder icon, and specify a folio folder containing article folders.
    • Choose Import Using sidecar.xml, click the Location folder icon, and specify a sidecar.xml file that includes pathnames of source files.
  5. If you're importing a single article, do the following, and then click OK.

    • Select a Smooth Scrolling setting for the article. For example, if you’re importing an article for a dual-orientation folio, but you want only the horizontal layout to be smooth scrolling, choose Horizontal Orientation.
    • Specify image format settings.

When you use the "Import a Single Article" or "Import Multiple Articles" option, your article folders can include .png images on the same level as the InDesign or HTML files. These .png images are then used as table of contents icons. If you import multiple articles in which the folio folder includes a classic sidecar.xml file, the file determines the order of articles and populates the article properties. See Create a metadata sidecar file for importing articles.

If your articles fail to import properly, see Troubleshoot article upload failures in Folio Builder panel.

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy