A microsite is an HTML website that is uploaded to Experience League directly instead of through the standard authoring pipeline. Microsites are useful for displaying HTML sample files or providing tools or services not available through markdown authoring.


Creating a microsite

  1. Create an AdobeDocs git repo that begins with microsite- (no .en suffix).

  2. Add the HTML files to the repo.

    • The main .html file (such as index.html) should be in root directory, with no other .html files on that level. This .html file is used in the URL.
    • If your microsite includes multiple .html files, put all those .html files in one or more subdirectories, and link to them from the main .html file.
    • Add all supporting CSS/JS/reference files.

    Microsite git repo

  3. Log a JIRA ticket (project = UGP; component = Authoring) with a title such as “Add microsite for <x>,” and assign it to Bob Bringhurst.

    Bob will work with you to determine the microsite URL. See image below for examples.

  4. (Admin task) Specify settings in the Microsites YAML file.

    Microsite config image

    Current top-level keys used in the URL include tools, landing, and developer. If new top-level keys are required, clone this ticket.

  5. Test the microsite.

  6. If the microsite is migrated, update links.

    • (Writer task) Update links in help articles.
    • (Admin task) Log JIRA ticket to change redirect exception (“reverse proxy”).

Adding Analytics files to your microsite content

In progress. We need information for:

  • Add metadata to HTML file for SEO, such as index: true.
  • Add analytics tracking files to HTML.

On this page