Adding Content Variations

This guide provides detailed instructions for setting up and configuring Content Variations in PersonalizeWP, including integration with other WordPress elements and technical best practices.

Setting Up Content Variations

Step 1: Add the Content Variations Block

  1. Edit any page or post in WordPress
  2. Click the '+' button to add a new block
  3. Search for "Content Variations" in the block selector
  4. Select the Content Variations block to add it to your page

The Content Variations block will appear with default setup options.

Step 2: Configure Your First Variation

  1. In the Content Variations block, click the "Add Variation" button
  2. Enter a descriptive name for your variation (e.g., "New Visitors")
  3. Add your content using the WordPress editor:
    • Text
    • Images
    • Videos
    • Other blocks (including other WordPress blocks)
  4. Save your variation

Step 3: Set Up Variation Rules

Rules determine when each variation will be shown to visitors.

  1. For your variation, click "Add Rule"
  2. Select a segment from the dropdown or create a new one
  3. Configure the conditions for this rule:
    • Select your targeting criteria (location, device, etc.)
    • Set specific values for each criterion
    • Combine multiple conditions with AND/OR logic if needed
  4. Set a priority level if you have multiple rules that could match simultaneously
  5. Save your rule

Step 4: Add Additional Variations

Repeat steps 2-3 to create more variations for different segments:

  1. Click "Add Variation" again
  2. Name and configure the new variation
  3. Add appropriate content
  4. Set up rules for when this variation should display
  5. Continue adding variations as needed

Step 5: Configure Fallback Content

Fallback content ensures all visitors see something appropriate, even if they don't match any specific rules.

  1. Add a variation labeled "Default" or "Fallback"
  2. Create content that works for all visitors
  3. Don't add any rules to this variation
  4. Make sure this variation is positioned last in your variation list

Step 6: Preview and Test

Before publishing, test your variations to ensure they work as expected:

  1. Use the preview mode to see how variations appear for different segments
  2. Test on different devices and from different locations if possible
  3. Check that your fallback content displays correctly when no rules match


Advanced Configuration Options

Using AND/OR Logic in Rules

Create complex rule combinations:

  1. Click "Add Condition" within a rule to add multiple conditions
  2. Select "AND" to require all conditions to be true
  3. Select "OR" to require any condition to be true
  4. You can combine multiple AND/OR conditions for sophisticated targeting

AND/OR Logic

Setting Display Time Limits

Make variations appear only during specific time periods:

  1. In the rule settings, add a time-based condition
  2. Set start and end dates/times for when the variation should be active
  3. Specify time zone if needed
  4. The variation will only display during this time window

Integration with Other WordPress Elements

The Content Variations block can be combined with any standard WordPress blocks or custom blocks to create personalised content experiences:

Combining with Standard WordPress Blocks

You can include any WordPress block inside your content variations:

  1. Add standard blocks like Paragraphs, Headings, Buttons, or Images inside your variation
  2. Each segment will see the appropriate blocks based on the variation rules
  3. This allows complete flexibility in creating personalised layouts and content
[Content Variation Block]
  [Variation 1 - New Visitors]
    [Heading Block]Welcome to Our Site![/Heading Block]
    [Paragraph Block]We're glad you found us. Here's what we offer...[/Paragraph Block]
    [Button Block]Explore Our Products[/Button Block]
  [/Variation 1]
  
  [Variation 2 - Returning Visitors]
    [Heading Block]Welcome Back![/Heading Block]
    [Paragraph Block]We've missed you. Check out what's new...[/Paragraph Block]
    [Button Block]Continue Shopping[/Button Block]
  [/Variation 2]
[/Content Variation Block]

Using with Third-Party Blocks

Content Variations work with many third-party blocks that are compatible with the Block Editor:

  1. Add the third-party block inside your content variation
  2. Configure the block settings as needed for each segment
  3. Test thoroughly to ensure compatibility

Performance Considerations

Caching Compatibility

When using Content Variations with caching plugins, proper configuration is essential to ensure personalised content displays correctly. PersonalizeWP requires specific cache exclusions to function properly.

For detailed instructions on configuring your caching plugin for compatibility with PersonalizeWP, please refer to our dedicated help article on Caching Exclusions.

The guide provides specific configuration steps for popular caching plugins to ensure your personalised content works correctly while maintaining the performance benefits of caching.

Resource Management

For resource-intensive pages:

  1. Prioritise variations for your most valuable segments
  2. Consider using simpler variations for less common segments
  3. Monitor page load times after implementing variations
  4. Use the PersonalizeWP performance settings to optimise delivery

Developer Integration

Working with the PersonalizeWP API

For developers looking to integrate with PersonalizeWP programmatically, please refer to the official API documentation in the PersonalizeWP Knowledge Base. The Knowledge Base provides comprehensive details on:

  • Available API endpoints
  • Authentication methods
  • Function references
  • Code examples and use cases
  • Best practices for integration

The API documentation will guide you through implementing personalised experiences beyond the standard block editor, allowing for custom theme integration and advanced personalisation scenarios.

For the most up-to-date information and examples, visit the PersonalizeWP API Documentation in our Knowledge Base.

Editor Compatibility

Currently, PersonalizeWP Content Variations are designed to work with:

  • WordPress Block Editor (Gutenberg)

Support for popular page builders such as Elementor, Beaver Builder, and Divi is planned for future releases. For the most up-to-date compatibility information, please refer to the PersonalizeWP documentation.

Troubleshooting Common Issues

Rules Not Triggering Correctly

If your variations aren't displaying as expected:

  1. Check rule priority settings
  2. Verify segment definitions are correct
  3. Check that your targeting conditions are configured properly
  4. Ensure your browser is accepting cookies, as they're necessary for visitor tracking

Conclusion

With this technical implementation guide, you should be able to set up and configure Content Variations effectively on your WordPress site.

If you encounter issues not covered in this guide, please contact our support team for assistance.

Still need help? Contact Us Contact Us