Applies to all v1 Instances:

• Working With Custom HTML Modules' Content Editors (WYSIWYG)
• General Tips and Advice for CMS Users
• Code Snippets

Applies to this instance only:

• Instance Notes
• CMS Page Templates
• Style Management
• Section Guide

How do I replace placeholder ("lorem ipsum") or unwanted text?

• Click the “BLOCKS” button to reveal outlines around block-level elements.
• Select and replace the text you wish to edit, or add new text and delete the placeholder.
• Avoid deleting all placeholder text before you have added your content. You will risk removing necessary markup.
• Edit text elements individually for best results.

Can I copy/paste from other sources?

• Be cautious when copy/pasting text into a Custom HTML module.
• Ensure copied text is plain text to avoid formatting issues (no html tags).

How do I change text appearance?

• Use the “STYLE” dropdown in the toolbar to add classes.
• Refer to Style Management for visual examples of available classes/styles.
• Change styles sparingly to maintain consistency with the module’s template.

Why isn't the STYLE dropdown applying the styles I expect?

Make sure you are following these guidelines:

• Only apply one class from within each category. For example, an element should not have multiple "Heading" classes applied.
• Style classes for links and buttons should be applied to links only.
• If the suggestions above don't solve your issue, click the “clear formatting” button to remove all classes from the element and then reapply classes.

How do I add/edit a link?

• Use the "insert/edit link" button in the toolbar.
• To edit a link, click the link text, then click the "insert/edit link" button.
• Create the link first before assigning a style dropdown class to it.
• Using proper link text is very important. For more details, see "Does link text matter?" in General Tips and Advice for CMS Users.

How do I add or edit an image?

• Use the "asset picker" button in the toolbar to add or modify images
• Avoid adding images to modules that didn’t already contain an image.
• Consider adding alt text for accessibility (editable through the "asset picker" button). For more details, see "Do I need to update/include alt text for every image?" in General Tips and Advice for CMS Users.

How do I add a code snippet?

• Use the "insert code snippet" button in the toolbar to add pre-made snippets of code into the content editor.
• Only use snippets meant for the specific module you’re editing (indicated by section number).
• Refer to the section dividers in this guide for the code snippet names used in templates.
• See Code Snippets for more information.

How can I revert to the original "lorem ipsum" placeholder content?

• Note the module’s "section number" and find the corresponding code snippet. Use the snippet to “reset” your content.
• Multiple snippets with the same section number may exist; choose based on the type of content that is in the module.
• The section dividers in this guide indicate the correct code snippet for the template.
• See Code Snippets for more information.

Does heading level (H1, H2, etc.) matter?

• Yes. For SEO and accessibility purposes.
• You must ensure a hierarchical structure: the top heading on the page should be H1.
• Avoid skipping heading levels on a page (e.g., don’t use H3 before H2).
• Use the "STYLE" dropdown to change the heading appearance without altering the heading level. Note that any applied style heading class will overwrite any native h# element styling.

Can I change the layout assignment of a page/section/module?

• Never change a layout assignment unless specifically instructed to do so in the relevant section's documentation found in the Section Guide. This will almost always lead to unintended results.

Can I add a module to a section?

• Never add a module to a section unless specifically instructed to do so in the relevant section's documentation found in the Section Guide. This will almost always lead to unintended results.

What should I name a section I’m creating from the “Add New” menu?

• Use consistent naming conventions.
• We recommend:
  • For sections used only on one page: “[Page Name OR Abbreviated Page Name] - [Section Template Name]”. Example: "Home - Image and Copy - (Section 27)"
  • For sections used on multiple pages: use a name summarizing its purpose/intent and include the section template name. Example: "Career Area CTAs - (Section 28)".
• Note: While you CAN change a section's name after creating it, you will NOT be able to change the names of the modules included in the section (which will, by default, include the ORIGINAL section name.) So we recommend that you carefully choose a good name for each section you create.

How do I choose a section template ("add new") from the Section Catalog menu?

• Use the "search" field and enter terms that summarize the type of content you want to add.
• Common keywords to try: "Image and Copy", "Testimonial", "Copy", "Multi Item".
• Searching by keyword will help you narrow down the list of results.

How do I create a "blank" page (not from a page template)?

• Please refer to the site instance notes in this guide.

Which theme should my page be assigned to?

• Assign CMS pages to the "Primary CMS Theme" only.

How do I add a Hero Banner?

• Choose a hero template from the Section Catalog ("add new") menu. The templates can be found by searching for the keyword "Hero".

Where should I upload asset files?

• Please refer to the site instance notes in this guide.

How can I ensure that my content will be accessible to all users?

• Follow the recommendations in this guide, especially regarding link text, image alt text, and heading levels.
• See Accessibility for Radancy CMS Publishers for more information.

Do I need to update/include alt text for every image?

• Consider alt text for images that are added or replaced. See this alt text decision tree for more details.
• Alt text can be left blank for descriptive, non-essential images.
• Alt text improves accessibility and SEO.

Does link text matter?

• Yes.
• For accessibility use meaningful link text that would still make sense if it were taken out of the surrounding context.
• Avoid "click here" or "learn more".

• Code snippets prefixed with "v1 - " may be used on any site instance.
• Code snippets prefixed with v1 and the instance name (example: "v1-APAC"), should only be used for the matching site instance. Please refer to the site instance notes in this guide.
• Only use code snippets with matching "Section Number" titles for the section you are editing.
• “Section Number” code snippets are typically used to reset a Custom HTML Module to its template state.
• If a code snippet does not include a section number in the name, you may use it in any custom html module.